MCP多功能服务器

一个多功能MCP服务器,提供计算工具、外部集成(webhooks)、上下文资源和提示模板。

  • by Arnie936
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 Arnie936/Agentic-MCP

使用说明

MCP多功能一体服务器

这是一个多功能的MCP服务器,演示了模型上下文协议(MCP)的多种功能。它提供了计算工具、外部集成(webhooks)、上下文资源和提示模板。

能力

🧮 工具

AI可以执行的功能:

  • 计算器:基本算术运算(add, subtract, multiply, divide).
  • Webhook集成: send_to_webhook -向配置的n8n工作流发送文本提示并返回响应。

📚 资源

AI可以读取的上下文数据:

  • support://playbook:一本完整的客户支持手册,其中包含公司概述、音调规则、产品详细信息和标准操作程序。

📝 提示

构建AI交互的模板:

  • webinar_to_blog:一个结构化的提示模板,用于将网络研讨会记录转换为引人入胜的博客文章。

先决条件

  • Python 3.10+
  • 紫外线:一个快速的Python包安装程序和解析器。
    • 窗户: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
    • macOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh
  • Node.js和npm (可选,适用于MCP检查员)

设置

  1. 在此目录中打开您的终端(calculator_server).
  2. 初始化项目(如果您还没有):
    uv init
    
  3. 添加所需的依赖关系:
    uv add "mcp[cli]" httpx
    

运行服务器

您可以直接使用以下命令运行服务器 uv:

uv run server.py

注意:这将使用stdio进行通信,因此它将期望来自stdin的输入,除非连接到MCP客户端,否则不会在控制台中显示太多输出。

MCP检验员测试

要使用MCP Inspector(一种基于web的与服务器交互的工具)测试服务器:

npx @modelcontextprotocol/inspector uv run server.py

这将在浏览器中启动检查器。你可以:

  • 工具:测试计算器和webhook工具。
  • 资源:查看的内容 support://playbook.
  • 提示:执行 webinar_to_blog 模板。

与Claude Desktop集成

要将此服务器与Claude for Desktop一起使用,请执行以下操作:

  1. 打开您的Claude Desktop配置文件:

    • 窗户: %APPDATA%\Claude\claude_desktop_config.json
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  2. 添加服务器配置。您可以从以下位置复制内容 claude_desktop_config.json 在此目录中:

    {
      "mcpServers": {
        "calculator": {
          "command": "uv",
          "args": [
            "--directory",
            "C:\\Users\\Your_Name\\Desktop\\mcps\\calculator_server",
            "run",
            "server.py"
          ]
        }
      }
    }
    

    重要:确保路径正确 --directory 匹配您的实际绝对路径 calculator_server 文件夹。

  3. 重新启动桌面版的Claude。