Ejemplo de Servidor MCP

MCP 服务示例

此仓库包含一个 Model Context Protocol（MCP）服务的实现。 这段代码演示了如何构建可与多个语言模型（LLM）客户端集成的实用 MCP 服务。

什么是 MCP？

MCP（Model Context Protocol）是一种开放协议，用于标准化应用向语言模型（LLM）提供上下文的方式。MCP 就像 AI 应用的 USB-C 接口，提供了一种标准化方式，将 AI 模型连接到不同的数据源和工具。

主要优势

• 不断增长的预构建集成列表，供你的 LLM 直接使用。
• 可灵活切换 LLM 提供商和供应商。
• 保护基础设施内数据的最佳实践。

架构概览

MCP 采用客户端-服务端架构，宿主应用可以连接到多个服务：

• MCP 宿主：Claude Desktop、IDE 或 AI 工具等需要通过 MCP 访问数据的程序。
• MCP 客户端：与服务保持 1:1 连接的协议客户端。
• MCP 服务：通过 Model Context Protocol 提供特定功能的轻量级程序。
• 数据源：服务可以访问的本地资源（文件、数据库）和远程服务（API）。

MCP 核心概念

MCP 服务可以提供三种主要能力：

• 资源：客户端可以读取的类文件数据（如 API 响应或文件内容）。
• 工具：LLM 可以调用的函数（需用户批准）。
• 提示词：帮助用户完成特定任务的预定义模板。

系统要求

• Python 3.10 或更高版本
• MCP SDK 1.2.0 或更高版本
• uv 包管理器

开始使用

安装 uv 包管理器

在 macOS/Linux 上：

curl -LsSf https://astral.sh/uv/install.sh | sh

在 Windows 上：

iwr -useb https://astral.sh/uv/install.ps1 | iex

安装后，请确保重启终端，以便使用 uv 命令。

项目配置

1. 创建并初始化项目：

# Crear un nuevo directorio para el proyecto
uv init mcp-server
cd mcp-server

# Crear y activar el entorno virtual
uv venv
source .venv/bin/activate  # En Windows: .venv\Scripts\activate

# Instalar dependencias
uv add "mcp[cli]" httpx

2. 创建服务实现文件：

touch main.py

运行服务

1. 启动 MCP 服务：

uv run main.py

2. 服务将准备好接受连接。

连接到 Claude Desktop

1. 从官方网站安装 Claude Desktop。
2. 配置 Claude Desktop 以使用你的 MCP 服务：

编辑文件 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
    "mcpServers": {
        "mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "/RUTA/ABSOLUTA/A/TU/mcp-server",
                "run",
                "main.py"
            ]
        }
    }
}

3. 重启 Claude Desktop。

故障排除

如果 Claude Desktop 未检测到你的服务：

1. 检查配置文件的路径和权限。
2. 确保配置中的绝对路径正确。
3. 确认已安装 uv 且可以访问。
4. 检查 Claude Desktop 日志中是否有错误。

许可证

此项目采用 MIT 许可证。详情请参阅 LICENSE 文件。

联系方式

• Leandro Rivera：[email protected]
• Linkedin：https://www.linkedin.com/in/leandrorivera/

编码愉快！🚀

如果你觉得这个项目有用，请在 GitHub 上点个 ⭐！😊