AI导哈

MCP服务器模板

一个基于Docker的HTTP MCP服务器模板，提供快速构建自定义MCP工具和服务的起点。

  • by DekaCube
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 dekacube/barebones-mcp

使用说明

骨干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

  2. 连接VS代码:

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

  3. 访问您的工具:

    • 在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

  2. 配置连接:

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

  3. 测试你的工具:

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

自定义模板

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

相关 MCP