Context7 MCP Python Server

Name: Context7 MCP Python Server
Author: noimank

Python License Version MCP

🚀 Context7 MCP Python版本服务器实现 - 为您的 AI 助手提供最新的代码文档

📋 项目概述

Context7 MCP Python Server 是一个高性能的 Model Context Protocol (MCP) 服务器实现，专为 AI 助手提供实时、准确的代码库文档和示例。通过与 Context7 API 的深度集成，为开发者提供最新的库文档、代码片段和最佳实践。

🎯 核心价值

🔄 实时更新: 获取最新的库文档和代码示例
🎯 智能搜索: 精准匹配您需要的技术文档
⚡ 高性能: 基于 FastMCP 框架，响应迅速
🌐 代理友好: 完善的网络代理支持
🔧 易于集成: 无缝集成到各种 MCP 客户端

✨ 功能特点

🔍 智能库搜索

精准匹配: 通过 resolve-library-id 工具快速定位目标库
多维度搜索: 支持库名、描述、标签等多种搜索方式
实时结果: 获取库的最新状态、版本信息和可信度评分

📚 文档获取服务

按需获取: 通过 get-library-docs 工具获取特定库的详细文档
主题筛选: 支持按主题获取相关文档片段
令牌控制: 灵活控制返回内容的长度和详细程度

🌐 网络连接优化

多重代理支持: 自动检测和配置 HTTP/HTTPS 代理
连接重试: 智能重试机制，确保服务稳定性
错误处理: 完善的错误处理和日志记录

🏗️ 架构优势

异步处理: 基于 asyncio 的高并发处理能力
类型安全: 使用 Pydantic 进行数据验证和类型检查
模块化设计: 清晰的代码结构，易于维护和扩展

🚀 快速开始

前置需求

Python 3.8 或更高版本
pip 包管理器

一键安装

pip install context7-mcp-python

基础使用

# 启动服务器（stdio 模式） context7-mcp-python # 启动 SSE 服务器 context7-mcp-python --transport sse --host 0.0.0.0 --port 8088

📦 安装指南

方式一：从 PyPI 安装（推荐）

pip install context7-mcp-python

方式二：从源码安装

git clone https://github.com/noimank/context7-mcp-python.git cd context7-mcp-python pip install -r requirements.txt

📖 使用文档

MCP 工具说明

🔍 `resolve-library-id`

搜索并获取 Context7 兼容的库 ID

参数:

library_name (string): 要搜索的库名称

示例:

# 搜索 React 库 resolve_library_id("react") # 搜索 FastAPI 库 resolve_library_id("fastapi")

返回格式:

📚 找到 3 个匹配的库: 🔹 facebook/react 📋 描述: A declarative, efficient, and flexible JavaScript library ⭐ Stars: 220000 | 🎯 信任度: 0.95 | 📊 令牌数: 850000 📅 最后更新: 2024-01-15 | 🏷️ 状态: active 🔹 react-native-community/react-native 📋 描述: A framework for building native apps using React ⭐ Stars: 115000 | 🎯 信任度: 0.88 | 📊 令牌数: 420000 📅 最后更新: 2024-01-14 | 🏷️ 状态: active

📚 `get-library-docs`

获取特定库的详细文档

参数:

context7_compatible_library_id (string): Context7 兼容的库 ID
topic (string, 可选): 文档主题筛选
tokens (integer, 可选): 最大令牌数量，默认 10000

示例:

# 获取 React 基础文档 get_library_docs("/facebook/react") # 获取 React Hooks 相关文档 get_library_docs("/facebook/react", topic="hooks", tokens=15000) # 获取 FastAPI 认证相关文档 get_library_docs("/tiangolo/fastapi", topic="authentication")

命令行选项

context7-mcp-python [选项] 选项: --transport {stdio,sse} 传输协议类型 (默认: stdio) --port PORT SSE 服务器端口 (默认: 34504) --host HOST SSE 服务器地址 (默认: localhost) -h, --help 显示帮助信息

⚙️ 配置说明

环境变量配置

代理设置

设置 HTTP 和 HTTPS 的代理环境变量，contex7-mcp-python会自动读取使用。

# Windows set HTTP_PROXY=http://proxy.example.com:8080 set HTTPS_PROXY=http://proxy.example.com:8080 # Linux/macOS export HTTP_PROXY=http://proxy.example.com:8080 export HTTPS_PROXY=http://proxy.example.com:8080

MCP 客户端集成

Cursor 等IDE 配置

在 ~/.cursor/mcp.json 中添加：

{ "mcpServers": { "context7-python": { "command": "uvx", "args":[ "context7-mcp-python" ] "env": { "HTTP_PROXY": "http://proxy.example.com:8080", "HTTPS_PROXY": "http://proxy.example.com:8080" } } } }

🛠️ 故障排除

常见问题

1. 网络连接问题

# 检查代理配置 echo $HTTP_PROXY echo $HTTPS_PROXY # 测试网络连接 curl -I https://context7.com/api/v1/search

2. 权限问题

# 确保有足够的权限 chmod +x server.py # 检查 Python 版本 python --version

3. 依赖冲突

# 重新安装依赖 pip uninstall context7-mcp-python pip install context7-mcp-python # 或使用虚拟环境 python -m venv fresh_env source fresh_env/bin/activate pip install context7-mcp-python

🤝 贡献指南

欢迎所有形式的贡献！

贡献方式

🐛 报告 Bug
💡 提出新功能建议
📝 改进文档
🔧 提交代码修复

提交流程

Fork 项目
创建功能分支 (git checkout -b feature/AmazingFeature)
提交更改 (git commit -m 'Add some AmazingFeature')
推送到分支 (git push origin feature/AmazingFeature)
创建 Pull Request

开发规范

遵循 PEP 8 代码风格
添加适当的测试用例
更新相关文档
确保所有测试通过

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

🙏 致谢

Context7 - 提供强大的 API 服务
FastMCP - 优秀的 MCP 框架
httpx - 现代的 HTTP 客户端
Pydantic - 数据验证库

📞 联系我

📧 Email: noimank@163.com
🐛 Issues: GitHub Issues
💬 Discussions: GitHub Discussions

⭐ 如果这个项目对您有帮助，请给项目一个 Star！

Made with ❤️ by noimank