MCP Server Python

🚀 MCP 服务器示例

本仓库包含实现模型上下文协议（MCP）的服务器代码，展示了如何构建功能完备的 MCP 服务器，该服务器可与多个语言模型客户端（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. 创建并初始化新项目：

# 在当前目录下创建新仓库
uv init mcp-server
cd mcp-server

# 创建并激活虚拟环境
uv venv
source .venv/bin/activate  # Windows 用户请使用：.venv\Scripts\activate

2. 安装依赖：

uv add "mcp[cli]" httpx

3. 创建服务器实现文件：

touch main.py

配置 Claude Desktop

若要将 MCP 服务器与 Claude Desktop 集成，请按以下步骤操作：

1. 打开 Claude 的设置菜单。
2. 导航至集成选项。
3. 添加 MCP 服务器配置，指定路径 /ruta/absoluta/para/tu/mcp-server。

示例命令

# 启动 MCP 服务器
uv run main.py

✨ 主要特性

什么是 MCP？

MCP（Model Context Protocol）是一个开放协议，它标准化了应用程序向语言模型提供上下文的方式。MCP 如同 AI 应用程序的“USB - C 端口”，以标准方式连接不同的数据源和工具与 AI 模型。

关键优势

• 拥有快速增长的预构建集成列表，可直接用于你的 LLM。
• 具备灵活性，可在不同 LLM 供应商和提供商之间切换。
• 遵循保护数据的最佳实践。

🔧 技术细节

架构概述

MCP 采用客户机 - 服务器架构，主机应用程序可连接多个服务器：

• MCP 主机：如 Claude Desktop、IDE 或其他 AI 工具，是希望通过 MCP 访问数据的应用程序。
• MCP 客户端：维护与服务器单线联系的协议客户端。
• MCP 服务器：提供特定功能（如文件访问或 API 调用）的轻量级程序。
• 数据源：可以是本地文件、数据库或远程服务（API 等），供 MCP 服务器访问。

MCP 关键概念

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

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

📄 联系方式

如有任何问题或反馈，请通过以下方式联系：

• 邮箱：[你的邮箱地址]
• LinkedIn：[你的 LinkedIn 链接]

愉快编码！🚀

如果你发现这个项目有用，请在 GitHub 上给我点个星星 😊