使用fastmcp创建mcp服务器
2026/11/18大约 1 分钟
分模块
projetc/
tools/
__init__.py
resources/
__init__.py
prompts/
__init__.py
fastmcp.json
generate_mcp_json.py
server.py__init__.py
在核心组件(tool、resource、prompt)模块的 init 文件中,声明一个注册函数:
from fastmcp import FastMCP
# 依赖注入,模块解耦
def register_prompts(mcp: FastMCP) -> None:
"""
汇总注册信息
"""实际注册发生在核心组件模块内的函数中,如:
def register_category_tools(mcp: FastMCP) -> None:
# 传递mcp实例,完成注册
@mcp.tool
def get_category() -> list[str]:
"""获取所有类别"""
return api_client.get_categories()fastmcp.json
{
"$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json",
"source": {
"path": "server.py",
"entrypoint": "mcp"
},
"environment": {
"dependencies": ["requests", "redis"]
}
}server.py
from fastmcp import FastMCP
def create_mcp() -> FastMCP:
m = FastMCP(
"Navigation Server",
instructions="Provides tools for managing navigation items."
)
# 注册工具、资源、提示词
# 从核心组件子模块导入注册函数
register_tools(m)
register_resources(m)
register_prompts(m)
return m
mcp = create_mcp()
if __name__ == "__main__":
mcp.run()导出配置
使用命令导出
fastmcp install mcp-json fastmcp.json是 "mcpServers" 字段对应的值,部分应用中需要自己补全这个字段,如
{ "mcpServers": $fastmcp.json }
使用generate_mcp_json.py
import json
import subprocess
import sys
import pyperclip
raw = subprocess.check_output(
["fastmcp", "install", "mcp-json", "fastmcp.json"],
text=True,
encoding="utf-8",
)
config = {
"mcpServers": json.loads(raw)
}
# 输出到终端
json.dump(config, sys.stdout, indent=2, ensure_ascii=False)
# 写入剪贴板 mcp json
# pyperclip.copy(json.dumps(config, indent=2, ensure_ascii=False))
# 写入剪贴板 args
servers = config["mcpServers"]
args: list[str] = servers.get(list(servers.keys())[0]).get("args")
pyperclip.copy("\n".join(args))- 完整的 mcp 配置,包含 "mcpServers" 字段
依赖配置
代码中使用了三方库,在运行mcp时可能出现依赖异常可以:
在
fastmcp.json中添加依赖,如{ "environment": { "dependencies": ["requests"] } }更改mcp配置,将运行参数改为
--directory,如:run --with fastmcp --with requests run --directory $project/ # 项目根路径