Barebones MCP Server

骨干MCP服务器

一个用于创建基于HTTP的模型上下文协议（MCP）服务器的最小、停靠模板。此模板为构建自己的MCP工具和服务提供了一个起点。

特性

• HTTP传输：已准备好使用HTTP MCP服务器设置
• Docker支持：使用Python 3.13进行容器化部署
• FastMCP框架：使用FastMCP库构建，便于MCP服务器开发
• 模板结构：干净、最少的代码库可供构建

包含什么

此模板包括一个简单的 get_cat_fact() 以工具为例，用您自己的工具和功能替换它。

快速开始

1. 构建并运行Docker容器:

   docker build -t mcp-server .
   docker run -p 8000:8000 mcp-server

1. 连接VS代码:

- 点击“开始”按钮 .vscode/mcp.json 出现在VS代码中的文件 - MCP服务器将自动配置和连接

1. 访问您的工具:

- 在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检查器：

1. 安装并运行MCP检查器:

   npx @modelcontextprotocol/inspector

1. 配置连接:

- 将运输类型设置为： httpstreamable - 将URL设置为： http://localhost:8000/mcp

1. 测试你的工具:

- 检查员将显示所有可用的工具及其模式 - 您可以直接从web界面测试每个工具 - 查看服务器功能并调试任何问题

自定义模板

1. 更换示例工具 在……里面 server.py 使用您自己的MCP工具
2. 更新依赖关系 在……里面 requirements.txt 根据需要
3. 修改服务器名称 在FastMCP构造函数中
4. 添加您的工具逻辑 使用 @mcp.tool() 装饰器