FindMCP Logo FindMCP.info
MCP Server Example

MCP Server Example

site icon
2025.03.18 0
Python教育工具开发工具开发效率
MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，用于教育目的。它展示了如何构建一个功能性的 MCP 服务器，可以与各种 LLM 客户端集成。MCP 是一个开放协议，标准化了应用程序如何向 LLM 提供上下文，类似于 AI 应用的 USB-C 端口，提供了连接 AI 模型到不同数据源和工具的标准方式。
View on GitHub

Overview

基本能力

产品定位

MCP Server 是一个教育性质的 MCP 服务器实现，用于展示如何构建和集成 MCP 服务器与 LLM 客户端。

核心功能

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

适用场景

  • 教育目的：学习如何构建和集成 MCP 服务器。
  • 开发测试：测试 MCP 协议的功能和性能。
  • 工具集成：将 MCP 服务器集成到 Claude Desktop 等 AI 工具中。

工具列表

  • MCP SDK：用于构建和运行 MCP 服务器的软件开发工具包。
  • uv 包管理器：用于管理项目依赖和运行服务器。

常见问题解答

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

使用教程

使用依赖

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

安装教程

  1. 安装 uv 包管理器（Windows）：
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  1. 项目设置：
# 创建新目录
uv init mcp-server
cd mcp-server

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

# 安装依赖
uv add "mcp[cli]" httpx

# 创建服务器实现文件
touch main.py
  1. 运行服务器：
uv run main.py

调试方式

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

许可证

None