MCP Server Example
2025.03.13
68
Python开发工具教育示例开发效率
MCP Server Example 是一个用于教育目的的 Model Context Protocol (MCP) 服务器实现。它展示了如何构建一个功能性的 MCP 服务器，可以与各种 LLM 客户端集成。MCP 是一个开放协议，标准化了应用程序如何向 LLM 提供上下文，类似于 AI 应用的 USB-C 端口，提供了一种标准化的方式将 AI 模型连接到不同的数据源和工具。
View on GitHub
Overview
基本能力
产品定位
MCP Server Example 是一个教育性质的 MCP 服务器实现，旨在展示如何构建和集成 MCP 服务器与 LLM 客户端。
核心功能
- 资源提供：提供类似文件的数据，可以被客户端读取（如 API 响应或文件内容）。
- 工具调用：提供可以被 LLM 调用的函数（需要用户批准）。
- 提示模板：提供预写的模板，帮助用户完成特定任务。
适用场景
- 教育目的：学习如何构建和集成 MCP 服务器。
- 开发测试：测试 MCP 协议的功能和兼容性。
- LLM 集成：将 MCP 服务器与各种 LLM 客户端集成。
工具列表
- uv 包管理器：用于安装和管理项目依赖。
- MCP SDK：提供构建 MCP 服务器所需的核心功能。
- httpx：用于处理 HTTP 请求的库。
常见问题解答
- 服务器未被 Claude Desktop 识别：检查配置文件路径和权限，确保绝对路径正确，验证 uv 是否安装并可访问，检查 Claude Desktop 日志中的错误消息。
使用教程
使用依赖
- Python 3.10 或更高版本
- MCP SDK 1.2.0 或更高版本
uv包管理器
安装 uv 包管理器（MacOS/Linux）：
curl -LsSf https://astral.sh/uv/install.sh | sh
安装教程
- 创建并初始化项目：
uv init mcp-server
cd mcp-server
uv venv
source .venv/bin/activate # Windows 使用: .venv\Scripts\activate
uv add "mcp[cli]" httpx
- 创建服务器实现文件：
touch main.py
调试方式
- 启动 MCP 服务器：
uv run main.py
-
配置 Claude Desktop 使用 MCP 服务器： 编辑
~/Library/Application Support/Claude/claude_desktop_config.json文件，添加服务器配置。 -
重启 Claude Desktop。