MCP服务器示例

此仓库包含 Model Context Protocol (MCP) 服务器的实现。 此代码演示了如何构建一个功能性的 MCP 服务器，该服务器可以与各种语言模型 (LLM) 客户端集成。

什么是 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 的关键概念

MCP 服务器可以提供三种主要类型的能力：

• 资源: 类似于文件的数据，可以被客户端读取（例如 API 响应或文件内容）。
• 工具: 可以被 LLM 调用的函数（需要用户批准）。
• Prompts: 预定义的模板，帮助用户完成特定任务。

系统要求

• 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. 创建并初始化项目：

# 创建项目的新目录
uv init mcp-server
cd mcp-server

# 创建并激活虚拟环境
uv venv
source .venv/bin/activate  # 在 Windows 上: .venv\Scripts\activate

# 安装依赖
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",
                "/你的/mcp-server/的/绝对/路径",
                "run",
                "main.py"
            ]
        }
    }
}

3. 重启 Claude Desktop。

故障排除

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

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

许可证

此项目根据 MIT 许可证获得许可。 有关更多详细信息，请参阅 LICENSE 文件。

联系方式

• Leandro Rivera: leo.232rivera@gmail.com
• Linkedin: https://www.linkedin.com/in/leandrorivera/

祝你编码愉快！ 🚀

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