mekayelanik/context7-mcp

Context7 MCP 服务器

用于分布式部署的多架构Docker镜像

---

📋 目录

• 概述
• 支持的架构
• 可用标签
• 快速开始
• 配置
• MCP客户端配置
• 网络配置
• 更新
• 故障排除
• 其他资源
• 支持与许可
• 主要变更

---

😎 请我喝杯咖啡 ☕︎

您的支持鼓励我继续创建/支持我的开源项目。 如果您从这个项目中获得了价值，可以请我喝杯咖啡，让我保持灵感。

概述

Context7 MCP Server是一款轻量级、高性能的模型上下文协议服务器，专为跨多架构的分布式部署设计。基于Alpine Linux构建，具有最小的资源占用和最高的安全性。

核心功能

✨ 多架构支持 - 原生支持x86-64和ARM64
🚀 多种传输协议 - 支持HTTP、SSE和WebSocket
🔒 安全设计 - 基于Alpine，***面最小
⚡ 高性能 - ZSTD压缩加速部署
🎯 生产就绪 - 稳定版本，全面测试
🔧 易于配置 - 简单的环境变量设置

---

支持的架构

💡 多架构镜像会自动为您的系统选择正确的架构。

---

可用标签

系统要求

• Docker引擎: 23.0+
• 内存: 最低512MB
• CPU: 单核即可

🔒 重要: 不要在没有适当安全措施（反向代理、SSL/TLS、身份验证、防火墙规则）的情况下将此容器直接暴露到互联网。

---

快速开始

Docker Compose（推荐）

yaml
services:
  context7-mcp:
    image: mekayelanik/context7-mcp:stable
    container_name: context7-mcp
    restart: unless-stopped
    ports:
      - "8010:8010"
    environment:
      - PORT=8010
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Dhaka
      - NODE_ENV=production
      - PROTOCOL=SHTTP
    hostname: context7-mcp
    domainname: local

部署:

bash
docker compose up -d
docker compose logs -f context7-mcp

Docker CLI

bash
docker run -d \
  --name=context7-mcp \
  --restart=unless-stopped \
  -p 8010:8010 \
  -e PORT=8010 \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Dhaka \
  -e NODE_ENV=production \
  -e PROTOCOL=SHTTP \
  mekayelanik/context7-mcp:stable

访问端点

⏱️ ARM设备: 访问端点前请允许30-60秒的初始化时间。

---

配置

环境变量

用户和组ID

查找您的ID并设置以避免权限问题：

bash
id username
# uid=1000(user) gid=1000(group)

时区示例

yaml
- TZ=Asia/Dhaka        # 孟加拉国
- TZ=America/New_York  # 美国东部
- TZ=Europe/London     # 英国
- TZ=UTC               # 世界标准时间

---

MCP客户端配置

传输支持

⚠️ *WebSocket为实验性功能（https://github.com/modelcontextprotocol/modelcontextprotocol/issues/1288%EF%BC%89

---

VS Code (Cline/Roo-Cline)

在 .vscode/settings.json 中配置：

json
{
  "mcp.servers": {
    "context7": {
      "url": "http://host_ip:8010/mcp",
      "transport": "http"
    }
  }
}

---

Claude桌面应用/Claude Code

配置：

带API_KEY

claude mcp add-json github '{"type":"http","url":"http://localhost:8045/mcp","headers":{"Authorization":"Bearer <YOUR_API_KEY>"}}'

不带API_KEY

claude mcp add-json github '{"type":"http","url":"http://localhost:8045/mcp"}'

---

Codex CLI

在 ~/.codex/config.json 中配置：

json
{
  "mcpServers": {
    "context7": {
      "transport": "http",
      "url": "http://host_ip:8010/mcp"
    }
  }
}

---

Codeium (Windsurf)

在 .codeium/mcp_settings.json 中配置：

json
{
  "mcpServers": {
    "context7": {
      "transport": "http",
      "url": "http://host_ip:8010/mcp"
    }
  }
}

---

Cursor

在 ~/.cursor/mcp.json 中配置：

json
{
  "mcpServers": {
    "context7": {
      "transport": "http",
      "url": "http://host_ip:8010/mcp"
    }
  }
}

---

测试配置

使用 https://github.com/modelcontextprotocol/inspector 验证：

bash
npm install -g @modelcontextprotocol/inspector
mcp-inspector http://host_ip:8010/mcp

---

网络配置

对比

---

桥接网络（默认）

yaml
services:
  context7-mcp:
    image: mekayelanik/context7-mcp:stable
    ports:
      - "8010:8010"

优势： 容器隔离，易于设置，随处可用
访问： http://localhost:8010/mcp

---

主机网络（仅Linux）

yaml
services:
  context7-mcp:
    image: mekayelanik/context7-mcp:stable
    network_mode: host

优势： 最高性能，无NAT开销，无需端口映射
注意事项： 仅Linux，共享主机网络命名空间
访问： http://localhost:8010/mcp

---

MACVLAN网络（高级）

yaml
services:
  context7-mcp:
    image: mekayelanik/context7-mcp:stable
    mac_address: "AB:BC:CD:DE:EF:01"
    networks:
      macvlan-net:
        ipv4_address: 192.168.1.100

networks:
  macvlan-net:
    driver: macvlan
    driver_opts:
      parent: eth0
    ipam:
      config:
        - subnet: 192.168.1.0/24
          gateway: 192.168.1.1

优势： 专用IP，直接LAN访问
注意事项： 仅Linux，需额外设置
访问： http://192.168.1.100:8010/mcp

---

更新

Docker Compose

bash
docker compose pull
docker compose up -d
docker image prune -f

Docker CLI

bash
docker pull mekayelanik/context7-mcp:stable
docker stop context7-mcp && docker rm context7-mcp
# 运行您原来的docker run命令
docker image prune -f

使用Watchtower一次性更新

bash
docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --run-once \
  context7-mcp

---

故障排除

预检清单

• ✅ Docker引擎23.0+
• ✅ 端口8010可用
• ✅ 足够的启动时间（ARM设备）
• ✅ 最新稳定镜像
• ✅ 正确的配置

常见问题

容器无法启动

bash
# 检查Docker版本
docker --version

# 验证端口可用性
sudo netstat -tulpn | grep 8010

# 检查日志
docker logs context7-mcp

权限错误

bash
# 获取您的ID
id $USER

# 使用正确的PUID/PGID更新配置
# 必要时修复卷权限
sudo chown -R 1000:1000 /path/to/volume

客户端无法连接

bash
# 测试连接
curl http://localhost:8010/mcp
curl http://host_ip:8010/mcp

# 检查防火墙
sudo ufw status

# 验证容器
docker inspect context7-mcp | grep IPAddress

ARM性能缓慢

• 启动后等待30-60秒
• 监控：docker logs -f context7-mcp
• 检查资源：docker stats context7-mcp
• 使用更快的存储（SSD vs SD卡）

调试信息

报告问题时，请包含：

bash
# 系统信息
docker --version && uname -a

# 容器日志
docker logs context7-mcp --tail 200 > logs.txt

# 容器配置
docker inspect context7-mcp > inspect.json

---

其他资源

文档

• 📚 https://github.com/upstash/context7
• 📦 NPM包
• 🔧 https://github.com/modelcontextprotocol/inspector

Docker资源

• 🐳 Docker Compose最佳实践
• 🌐 Docker网络
• 🛡️ Docker安全

监控

• 📊 Diun - 更新通知器
• ⚡ Watchtower

---

😎 请我喝杯咖啡 ☕︎

您的支持鼓励我继续创建/支持我的开源项目。 如果您从这个项目中获得了价值，可以请我喝杯咖啡，让我保持灵感。