FindMCP Logo FindMCP.info
MCP Server Example

MCP Server Example

site icon
2025.03.21 0
开发效率开发效率
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 协议的功能和兼容性。
  • 工具集成：将 MCP 服务器集成到现有的 AI 工具中。

工具列表

  • uv 包管理器：用于安装和管理项目依赖。
  • MCP SDK：提供 MCP 协议的核心功能和支持。
  • httpx：用于 HTTP 请求的库。

常见问题解答

  • 服务器未被 Claude Desktop 识别：检查配置文件路径和权限，确保绝对路径正确，验证 uv 是否安装并可访问，查看 Claude Desktop 日志中的错误信息。

使用教程

使用依赖

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

安装教程

  1. 安装 uv 包管理器（MacOS/Linux）：
curl -LsSf https://astral.sh/uv/install.sh | sh
  1. 创建并初始化项目：
uv init mcp-server
cd mcp-server
uv venv
source .venv/bin/activate  # Windows 使用: .venv\Scripts\activate
uv add "mcp[cli]" httpx
  1. 创建服务器实现文件：
touch main.py

调试方式

  1. 启动 MCP 服务器：
uv run main.py

  1. 配置 Claude Desktop 使用 MCP 服务器： 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json 文件，添加服务器配置。

  2. 重启 Claude Desktop。

许可证

该项目遵循 MIT 开源许可条款。