模型上下文协议服务器

一个使用FastMCP的最小化模型上下文协议服务器,提供计算工具、解释提示和资源访问功能。

  • by michaelmoser8875
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 michaelmoser8875/MCP-Server

使用说明

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.