MCP Tool Server (

@planetf1

About MCP Tool Server (

Simple mcp server for testing

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-planetf1": {
      "command": "python",
      "args": [
        "mcp_server.py",
        "[tools_paths...]",
        "[--log",
        "FILENAME]",
        "[--transport",
        "{stdio,sse}]",
        "[--port",
        "PORT]"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Tool Server?

MCP Tool Server is an asynchronous Python server that exposes Python functions as "tools" over stdio or SSE transports using the FastMCP framework. It is intended for developers who want to make custom Python functions callable via the Model Context Protocol.

How to use MCP Tool Server?

Run python mcp_server.py with optional positional paths to tool files or directories, plus flags like --log FILENAME, --transport {stdio,sse}, and --port PORT. With no arguments, only the built-in echo and health tools are available.

Key features of MCP Tool Server

Supports stdio and SSE transports
Built-in echo and health tools
Dynamically loads custom tools from Python files or directories
Configurable console and file-based logging
Asynchronous design for concurrent operations

Use cases of MCP Tool Server

Expose a calculator function as a callable tool for an MCP client
Serve a collection of data‑processing utilities from a folder of Python files
Enable web clients to subscribe to tool outputs via SSE
Debug tool behavior with verbose file logging

FAQ from MCP Tool Server

What transports does MCP Tool Server support?

It supports stdio (standard input/output) and SSE (Server-Sent Events, listens on http://<host>:<port>/sse). The default transport is stdio.

How do I add custom tools?

Provide paths to Python files or directories containing Python files as positional arguments. Each file must define exactly one function, which becomes a tool. Files starting with _ are ignored.

What are the built-in tools?

The built-in tools are echo (returns its parameters) and health (returns "ready").

How do I enable detailed logging?

Use the --log FILENAME option. This writes DEBUG‑level logs for both the server and the MCP SDK to the specified file, while INFO‑level messages still appear on the console.

How do I shut down the server gracefully?

Press Ctrl+C to shut down the server.

Frequently asked questions

What transports does MCP Tool Server support?

It supports stdio (standard input/output) and SSE (Server-Sent Events, listens on `http://<host>:<port>/sse`). The default transport is stdio.

How do I add custom tools?

Provide paths to Python files or directories containing Python files as positional arguments. Each file must define exactly one function, which becomes a tool. Files starting with `_` are ignored.

What are the built-in tools?

The built-in tools are `echo` (returns its parameters) and `health` (returns "ready").

How do I enable detailed logging?

Use the `--log FILENAME` option. This writes DEBUG‑level logs for both the server and the MCP SDK to the specified file, while INFO‑level messages still appear on the console.

How do I shut down the server gracefully?

Press `Ctrl+C` to shut down the server.

Comments

Basic information

More Other MCP servers

MCP Go 🚀

mark3labs

A Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.

8.9K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K