MCP 入门到自建：协议原理 + MCPHub 管理 + 自己写一个

1
{
2
  "mcpServers": {
3
    "filesystem": {
4
      "command": "npx",
5
      "args": [
6
        "-y",
7
        "@modelcontextprotocol/server-filesystem",
8
        "/path/to/allowed/directory"
9
      ]
10
    }
11
  }
12
}

1
services:
2
  mcphub:
3
    image: mcphub/mcphub:latest
4
    container_name: mcphub
5
    restart: always
6
    ports:
7
      - "127.0.0.1:3000:3000"
8
    volumes:
9
      - /opt/mcphub/data:/data
10
    environment:
11
      - TZ=Asia/Shanghai

1
{
2
  "mcpServers": {
3
    "mcphub": {
4
      "command": "npx",
5
      "args": ["-y", "mcphub-client", "http://127.0.0.1:3000"]
6
    }
7
  }
8
}

1
from mcp.server.fastmcp import FastMCP
2
import httpx
3

4
mcp = FastMCP("weather")
5

6
@mcp.tool()
7
async def get_weather(city: str) -> str:
8
    """查询指定城市今日天气。
9

10
    Args:
11
        city: 城市名（中文或英文）
12
    """
13
    # 示意：替换成真实天气 API
14
    async with httpx.AsyncClient() as client:
15
        r = await client.get(
16
            f"https://wttr.in/{city}",
17
            params={"format": "3"},
18
            timeout=10,
19
        )
20
        return r.text
21

22
@mcp.resource("weather://cities")
23
def list_cities() -> str:
24
    """支持查询的城市列表。"""
25
    return "Beijing, Shanghai, Shenzhen, Tokyo, New York, London"
26

27
@mcp.prompt()
28
def weather_check(city: str) -> str:
29
    """生成查天气的标准 prompt。"""
30
    return f"请帮我查 {city} 今天的天气，并建议穿衣。"
31

32
if __name__ == "__main__":
33
    mcp.run(transport="stdio")

1
{
2
  "mcpServers": {
3
    "weather": {
4
      "command": "python",
5
      "args": ["/absolute/path/to/server.py"]
6
    }
7
  }
8
}