┌─────────────────────────┐      JSON-RPC over stdio/SSE      ┌──────────────────────┐
│  MCP Client             │ ◄──────────────────────────────►  │  mcptools            │
│                         │                                    │                      │
│  Claude Desktop         │                                    │  MCP Server          │
│  VS Code (Cline)        │                                    │  提供各种工具         │
│  pi / 其他 AI Agent     │                                    │  可扩展注册系统       │
└─────────────────────────┘                                    └──────────────────────┘

cd /Users/fb0sh/Temp/mcptools
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

# stdio 模式（默认）
mcptools

# SSE 模式（像传统 C/S）
mcptools --transport sse --port 8080

{
  "mcpServers": {
    "mcptools": {
      "command": "/Users/fb0sh/Temp/mcptools/.venv/bin/python",
      "args": ["/Users/fb0sh/Temp/mcptools/mcptools/server.py"]
    }
  }
}

{
  "servers": {
    "mcptools": {
      "type": "stdio",
      "command": "/Users/fb0sh/Temp/mcptools/.venv/bin/python",
      "args": ["/Users/fb0sh/Temp/mcptools/mcptools/server.py"]
    }
  }
}

# 终端 1：先手动启动 Server
mcptools --transport sse --port 8080

// 然后配置 Client 通过地址连接
{
  "mcpServers": {
    "mcptools": {
      "url": "http://localhost:8080/sse"
    }
  }
}

# mcptools/tools/weather_tools.py
from mcptools.registry import tool

@tool(name="get_weather", description="查询城市天气")
def get_weather(city: str, days: int = 1) -> str:
    """查询天气

    city: 城市名
    days: 预报天数（默认 1）
    """
    # 你的逻辑...
    return f"{city} 未来 {days} 天天气：晴 ☀️"

from mcptools.registry import tool

@tool(name="hello", description="Say hello")
def hello(name: str) -> str:
    return f"Hello, {name}!"

from mcptools.registry import registry

def my_tool(keyword: str) -> list:
    return ["result1", "result2"]

registry.register(my_tool, name="search", description="搜索关键词")

from mcptools import create_server

# 创建 Server（自动发现 tools/ 下的所有工具）
server = create_server()

# stdio 模式
server.run(transport="stdio")

# 或 SSE 模式
server.run(transport="sse")

mcptools/
├── __init__.py          # 包入口，导出 create_server
├── __main__.py          # python -m mcptools 入口
├── registry.py          # 核心：@tool 装饰器 + ToolRegistry 注册器
├── server.py            # FastMCP 服务器 + CLI（支持 stdio/SSE）
└── tools/               # 工具模块目录（自动发现）
    ├── __init__.py
    ├── system_tools.py  # 系统工具（system_info）
    └── nmap_tools.py    # nmap 网络扫描工具集