MCP Server Context7

MCP服务器上下文7

一种模型上下文协议（MCP）服务器，提供对Context7 API的访问，用于搜索和下载库文档和源代码存储库。

🤖 使用Copilot构建：该项目通过以下方式实施 副驾驶振动编码 -使用GitHub Copilot进行快速原型制作和实施的人工智能辅助开发方法。

关于：这个项目是Upstash优秀的Python移植 背景7 MCP服务器，增强了本地文档管理和自动存储库克隆等附加功能。服务器上下文7

⚠️ 重要：该项目已提供 按原样 随着 无维修承诺。对于生产使用或持续支持，请分叉此存储库并维护您自己的版本。

特性

• 搜索库：跨Context7广泛的库数据库进行语义搜索
• 获取文档：下载任何库的综合文档
• 存储库同步：自动克隆关联的GitHub存储库
• 本地管理：列出并浏览下载的文档
• 索引维护：用于跟踪下载的自动INDEX.md文件管理

安装

快速安装（推荐）

# Clone the repository
git clone https://github.com/jussker/mcp_server_context7.git
cd mcp_server_context7

# Run the install script (creates isolated virtual environment)
chmod +x install.sh
./install.sh

安装脚本将：

• ✅ 检查Python版本（需要3.10+）
• ✅ 创建隔离的虚拟环境 .venv
• ✅ 安装所有依赖项
• ✅ 提供完整的MCP配置示例

手动安装

如果您更喜欢手动控制安装过程：

# Clone the repository
git clone https://github.com/jussker/mcp_server_context7.git
cd mcp_server_context7

# Create virtual environment
python3 -m venv .venv
source .venv/bin/activate  # Linux/Mac
# or .venv\Scripts\activate  # Windows

# Install dependencies
pip install -e .

UV安装

如果你正在使用 uv 包管理器：

# Install directly from Git repository
uv add git+https://github.com/jussker/mcp_server_context7.git

# Or clone and install locally
git clone https://github.com/jussker/mcp_server_context7.git
cd mcp_server_context7
uv add -e .

验证安装

# Test run
./.venv/bin/python mcp_server_context7.py

VS代码MCP配置

紫外线安装（推荐）

如果你正在使用 uv 包管理器，使用此配置：

{
  "servers": {
    "context7": {
      "command": "uv",
      "args": ["run", "python3", "-m", "mcp_server_context7"],
      "env": {
        "CLIENT_IP_ENCRYPTION_KEY": "000102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f"
      }
    }
  }
}

快速安装/手动安装

如果你使用 ./install.sh 或手动安装，请使用以下配置：

{
  "servers": {
    "context7": {
      "command": "/path/to/mcp_server_context7/.venv/bin/python",
      "args": ["/path/to/mcp_server_context7/mcp_server_context7.py"],
      "env": {
        "CLIENT_IP_ENCRYPTION_KEY": "000102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f"
      }
    }
  }
}

需要代理支持？

如果您需要代理支持，只需将代理环境变量添加到上述任何配置中即可：

{
  "env": {
    "CLIENT_IP_ENCRYPTION_KEY": "000102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f",
    "http_proxy": "http://127.0.0.1:8890",
    "HTTP_PROXY": "http://127.0.0.1:8890",
    "https_proxy": "http://127.0.0.1:8890", 
    "HTTPS_PROXY": "http://127.0.0.1:8890",
    "all_proxy": "socks5://127.0.0.1:8890"
  }
}

配置优势

✅ 完全隔离：使用专用虚拟环境，不污染系统Python\ ✅ 简单可依赖：直接指定Python解释器和脚本路径\ ✅ 跨平台：适用于Linux、macOS和Windows\ ✅ 易于调试：可以直接运行测试和排除故障

用法

运行MCP服务器

如果通过紫外线安装：

uv run python -m mcp_server_context7

如果通过快速安装或手动安装安装：

# From the project directory
python mcp_server_context7.py
# or
./.venv/bin/python mcp_server_context7.py

可用工具

1. search_librarys（查询，client_ip=无）

- 搜索与查询匹配的库 - 返回带有库详细信息的格式化结果

1. fetch_library_documentation（库_id，主题=无，令牌=无，客户端_ip=无，save_to_file=True，sync_repo=False，搜索查询=无）

- 下载库文档 - 可选择同步源代码存储库 - 自动维护INDEX.md

1. list_downloaded_librarys（base_dir=“.km/context7/km base”）

- 列出以前下载的所有库 - 显示文件大小、修改日期和存储库状态

1. get_library_content（文件名，base_dir=“.kms/context7/km-base”，max_chars=10000）

- 从下载的文档中读取内容 - 支持对大文件进行内容截断

示例用法

# Search for libraries
results = search_libraries("fastapi web framework")

# Download documentation with repository sync
doc = fetch_library_documentation(
    library_id="tiangolo/fastapi",
    search_query="fastapi web framework",
    sync_repo=True
)

# List downloaded libraries
libraries = list_downloaded_libraries()

# Read library content
content = get_library_content("tiangolo_fastapi.md", max_chars=5000)

配置

环境变量

• CLIENT_IP_ENCRYPTION_KEY：用于加密客户端IP的64个字符的十六进制密钥（可选）

目录结构

.kms/context7/
├── km-base/                    # Documentation storage
│   ├── INDEX.md               # Auto-maintained index
│   ├── library_name.md        # Documentation files
│   └── library_name_repo/     # Cloned repositories
└── scripts/                   # Reserved for future CLI tools

基于上下文7

此MCP服务器基于 背景7 Upstash的项目，该项目提供了对大量图书馆文档的语义搜索。

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

贡献

⚠️ 维护公告：本项目按原样提供，没有持续的维护承诺。

如果您需要功能、错误修复或长期支持，我们建议：

1. 分叉此存储库 供您自用
2. 创建自己的维护版本
3. 提交拉取请求 （如有可能，将对其进行审查，但不保证时间表）

为该存储库做出贡献：

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 手动测试您的更改
5. 提交拉取请求

备注：此项目目前没有自动测试。请在提交之前手动测试您的更改。

支持

⚠️ 有限的支持：本项目按原样提供，支持有限。

对于问题和疑问：

• 首先，尝试自己分叉并解决问题 -这是推荐的方法
• 检查现有的GitHub问题，看看你的问题是否已被报告
• 查看Context7文档，网址为https://context7.com用于API相关问题
• 仅针对关键错误打开GitHub问题，但预计响应有限

对于商业或关键任务用途，我们强烈建议分叉此存储库并维护您自己的版本。

项目URL

• 存储库：https://github.com/jussker/mcp_server_context7
• 问题：https://github.com/jussker/mcp_server_context7/issues

文档

• 英文自述
• 中文 README