MCP Server Example

基本能力

产品定位

docs-MCP-server 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在为最新的文档提供标准化接口。

核心功能

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

适用场景

• 集成到 AI 工具（如 Claude Desktop、IDE）中，为 LLM 提供上下文信息。
• 连接本地或远程数据源（如文件、数据库、API）到 LLM 客户端。
• 提供标准化接口，方便切换不同的 LLM 提供商。

工具列表

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

常见问题解答

• 如何安装 uv 包管理器？
• MacOS/Linux：curl -LsSf https://astral.sh/uv/install.sh | sh
• Windows：pip install uv
• 如何启动 MCP 服务器？
• 运行 uv run main.py

使用教程

使用依赖

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

安装教程

1. 克隆并初始化项目：

git clone https://github.com/wolderufael/docs-MCP-server.git
cd docs-mcp-server
uv venv
source .venv/bin/activate  # Windows 使用: .venv\Scripts\activate
uv venv sync

1. 启动 MCP 服务器：

uv run main.py

调试方式

1. 确保服务器已启动并运行：

uv run main.py

1. 检查日志输出以确认服务器是否正常运行。
2. 配置 Cursor ai 以使用 MCP 服务器：
3. 编辑 .cursor\mcp.json 文件，配置服务器路径和命令。

许可证

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