MCP服务器工具

使用FastMCP创建的MCP服务器,提供比特币价格查询、实时天气查询和系统实用工具等功能,适用于MCP客户端(如Claude Desktop、Open WebUI)。

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

使用说明

MCP 服务器

用创建的MCP服务器 FastMCP 高一点 “使用Python和FastMCP创建您的第一个MCP服务器”.

该REPO包括MCP服务器的示例,这些服务器公开了工具等功能(tools)可从MCP客户机(例如Claude Desktop、Open Webui)访问。

  • 📈 比特币MCP →以美元返回BTC的当前价格。
  • 🌦 ClimaMCP →实时查询城市天气。
  • 🖥 RedMCP →基本系统实用程序(流程、日志等)。

🚀 要求

  • Python 3.10+
  • pip 更新
  • (可选) node / npm 如果你想使用 MCP检查员

📂 项目结构


Servidores-MCP/
├─ bitcoin.py
├─ clima.py
├─ red.py
├─ requirements.txt
└─ README.md


⚙️ 安装

  1. 克隆存储库:

    git clone https://github.com/jmatias2411/Servidores-MCP.git
    cd Servidores-MCP
    
  2. 创建虚拟环境并安装依赖项:

    python -m venv .venv
    source .venv/bin/activate   # Linux/macOS
    .\.venv\Scripts\Activate.ps1 # Windows PowerShell
    
    pip install --upgrade pip
    pip install -r requirements.txt
    

厄尔 requirements.txt 包含:

fastmcp
requests
pandas

▶️ 运行服务器

每个文件都会引发不同的MCP服务器。

比特币MCP

python bitcoin.py

ClimaMCP

python clima.py

RedMCP

python red.py

当服务器运行时,您将看到日志类型:

FastMCP Starting server: BitcoinMCP
Tools: ['precio_bitcoin']

🔍 与MCP检查员一起测试

MCP检查员 就像MCP的postman:它允许您在将工具连接到LLM之前查看和运行它们。

安装:

npm install -g @modelcontextprotocol/inspector

示例:

mcp-inspector python bitcoin.py

将在您的浏览器中打开一个用户界面:

  • 工具清单
  • 发送参数的窗体
  • JSON实时响应

🤖 连接到MCP客户端

配置示例(mcp_servers.json)这就像克劳德桌面u打开webui:

{
  "servers": {
    "BitcoinMCP": {
      "command": "python",
      "args": ["bitcoin.py"]
    },
    "ClimaMCP": {
      "command": "python",
      "args": ["clima.py"]
    },
    "RedMCP": {
      "command": "python",
      "args": ["red.py"]
    }
  }
}

将此文件放入客户机配置文件夹并重新启动。


✅ 良好做法

  • 补充 类型提示 对于您的工具→FastMCP自动使用JSON模式生成验证。
  • 没有验证就不要暴露系统命令(shell=True 这是危险的)。
  • 限制响应大小(例如大日志)。
  • 美国 mcp-inspector 在连接到真正的LLM之前进行测试。

🛠 快速故障排除

  • 检查员中没有出现工具 →检查函数是否具有 @tool y型提示。
  • python: command not found →使用VENV可执行文件的绝对路径。
  • REDMCP中的权限错误 →确保您在系统中拥有适当的权限。

📜 许可证

免费用于教育目的。🚀