使用说明
MCP服务器(FastMCP)
最低限度 模型上下文协议 服务器使用 FastMCP,一个工具、一个提示和一个资源。
| 类型 | 名称 | 描述 |
|---|---|---|
| 工具 | calculate |
安全数学表达式评估(sqrt, sin, pi等等) |
| 提示 | explain |
让模特用简单的语言解释一个话题 |
| 资源 | app://info |
服务器名称和功能(只读) |
需求
- Python 3.10+
- 点
设置
1.创建并激活虚拟环境
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
2.安装依赖项
pip install -r requirements.txt
3.运行服务器
MCP服务器使用 标准 默认情况下。您的MCP客户端启动该进程。要验证它是否启动:
python server.py
# Blocks waiting for MCP messages. Press Ctrl+C to quit.
连接到克劳德桌面
添加到您的Claude Desktop配置中:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 视窗:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"example-server": {
"command": "/absolute/path/to/MCP-Server/.venv/bin/python",
"args": ["/absolute/path/to/MCP-Server/server.py"]
}
}
}
使用您的实际路径并重新启动Claude Desktop。
与MCP仪表板一起使用
MCP仪表板将此服务器作为子进程启动,并通过stdio与之通信,因此工具、资源和提示都显示在UI中。
从MCP Dashboard目录(安装了Flask)运行:
# Unbuffered (-u) so the dashboard receives list responses immediately
python app.py -- python -u path/to/MCP-Server/server.py
窗户:
python app.py -- python -u path\to\MCP-Server\server.py
使用同时具备这两个特性的Python flask 和 fastmcp 已安装(如果使用此仓库的venv Python,请使用其完整路径)。
仪表板将在以下时间打开http://localhost:8080并显示 计算 工具, app://info 资源,以及 解释 提示。您可以尝试该工具,阅读资源,并从浏览器中获得提示。
参考
工具: calculate
- 输入:
{ "expression": "sqrt(2) * pi" } - 输出:
"4.442882938158366" - 支持:
+,-,*,/,**,%,//,功能如下abs,round,sqrt,ceil,floor,log,log10,sin,cos,tan;常数pi,e.
提示: explain
- 输入:
{ "topic": "recursion" } - 返回一条用户消息,要求模型用简单的术语解释主题。
资源: app://info
- 只读。返回JSON:
{"name": "mcp-server", "capabilities": ["calculate", "prompts", "resources"]}.
项目结构
MCP-Server/
├── server.py
├── requirements.txt
└── README.md
要添加更多工具、提示或资源,请使用 @mcp.tool, @mcp.prompt,以及 @mcp.resource(...) 室内装饰师 server.py.