骨干MCP服务器
一个用于创建基于HTTP的模型上下文协议（MCP）服务器的最小、停靠模板。此模板为构建自己的MCP工具和服务提供了一个起点。
特性
- HTTP传输：已准备好使用HTTP MCP服务器设置
- Docker支持：使用Python 3.13进行容器化部署
- FastMCP框架：使用FastMCP库构建，便于MCP服务器开发
- 模板结构：干净、最少的代码库可供构建
包含什么
此模板包括一个简单的 get_cat_fact() 以工具为例，用您自己的工具和功能替换它。
快速开始
- 构建并运行Docker容器:
docker build -t mcp-server .
docker run -p 8000:8000 mcp-server- 连接VS代码:
- 点击“开始”按钮 .vscode/mcp.json 出现在VS代码中的文件 - MCP服务器将自动配置和连接
- 访问您的工具:
- 在VS Code中打开聊天面板 - 点击扳手图标(🔧) 查看可用的MCP工具 - 你的 get_cat_fact() 工具应该出现并准备好使用 - 使用以下提示进行测试： - “你看到猫事实mcp工具了吗？” - “给我一个猫的事实” - 备注：AI代理应在执行之前提示您它将使用MCP工具。如果您没有看到此提示，则表示该工具未被使用。
MCP配置
将此添加到您的 .vscode/mcp.json 文件：
{
"servers": {
"my-mcp-tools": {
"url": "http://localhost:8000/mcp"
}
}
}可用工具（示例）
get_cat_fact()：返回随机猫事实的示例工具-替换为您自己的工具
使用MCP检查器进行调试
为了调试和测试您的MCP服务器，您可以使用MCP检查器：
- 安装并运行MCP检查器:
npx @modelcontextprotocol/inspector- 配置连接:
- 将运输类型设置为： httpstreamable - 将URL设置为： http://localhost:8000/mcp
- 测试你的工具:
- 检查员将显示所有可用的工具及其模式 - 您可以直接从web界面测试每个工具 - 查看服务器功能并调试任何问题
自定义模板
- 更换示例工具 在……里面
server.py使用您自己的MCP工具 - 更新依赖关系 在……里面
requirements.txt根据需要 - 修改服务器名称 在FastMCP构造函数中
- 添加您的工具逻辑 使用
@mcp.tool()装饰器