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

1. 创建虚拟环境并安装依赖项：

   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中的权限错误 →确保您在系统中拥有适当的权限。

______________________________________________________________________

📜 许可证

免费用于教育目的。🚀