MCP代码上下文
项目介绍
Claude Context MCP - 本地设置
一个使用Docker容器运行claude-context MCP服务器的独立设置，使用本地服务。
🎯 概述
此仓库提供了一个完全本地部署的Claude Context MCP服务器，包括：
- MILVUS - 用于存储嵌入向量的本地向量数据库
- Ollama - 本地嵌入模型推理
- Docker - 容器化服务，便于设置
✨ 特性
- 🔒 完全本地 - 无云依赖，所有数据都保留在您的机器上
- 🚀 一键设置 - Windows和Linux的自动化脚本
- 🐳 基于Docker - 跨平台一致的环境
- 📦 自包含 - 所需的一切都在一个仓库中
📋 先决条件
在开始之前，请确保您已安装：
- Docker 和 Docker Compose
- Node.js (>= 20.0.0 并且 < 24.0.0)
- VS Code (用于MCP集成)
- 至少 8GB 内存 可供Docker容器使用
- 至少 4GB 磁盘空间 用于模型和数据库
🏢 企业代理/防火墙用户
⚠️ 重要提示：如果您位于企业代理（例如Cisco Umbrella、Zscaler）后面，您需要在运行设置之前添加您的CA证书。
快速步骤：
- 导出您组织的根CA证书
- 将其放置在
ollama/res/Cisco_Umbrella_Root_CA.cer - 运行设置脚本（它会自动使用您的证书构建）
📖 请参阅 CORPORATE_PROXY_SETUP.md 获取完整的分步说明。
如果您不在企业代理后面，可以跳过这一步 - 默认设置将正常工作。
安装Docker
Windows:
- 下载并安装Docker Desktop for Windows
- 确保启用WSL 2
Linux:
# Ubuntu/Debian
sudo apt-get update
sudo apt-get install docker.io docker-compose
sudo systemctl start docker
sudo systemctl enable docker
sudo usermod -aG docker $USER
安装Node.js
Windows:
- 从nodejs.org下载（LTS版本20.x或22.x）
Linux:
# 使用nvm（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20
🚀 快速开始
1. 克隆仓库
git clone https://github.com/mauricekastelijn/mcp-code-context.git
cd mcp-code-context
2. 运行设置脚本
Windows (PowerShell):
.\setup-windows.ps1
Linux/Mac:
chmod +x setup-linux.sh
./setup-linux.sh
这将：
- 在Docker中启动MILVUS数据库
- 在Docker中启动Ollama服务
- 下载
nomic-embed-text嵌入模型 - 验证所有服务是否正在运行
3. 配置VS Code
按照VSCODE_SETUP.md中的说明将MCP服务器添加到VS Code。
4. 验证设置
Windows:
.\verify-setup.ps1
Linux/Mac:
chmod +x verify-setup.sh
./verify-setup.sh
这将检查所有服务是否正确运行。
5. 开始使用
查看USAGE.md以获取详细的索引代码库和使用MCP服务器的说明。
查看EXAMPLES.md以获取实际示例和真实用例。
📚 文档
入门
- 快速参考 - 快速命令和快捷方式
- VS Code 设置 - 在VS Code中配置MCP服务器
- 使用指南 - 如何使用MCP服务器
- 示例 - 实际示例和用例
- 企业代理设置 - 在企业防火墙后设置
详细指南
贡献
- 贡献指南 - 如何为此项目做出贡献
🔧 架构
┌─────────────────┐
│ VS Code │
│ (MCP客户端) │
└────────┬────────┘
│
▼
┌─────────────────┐
│ Claude Context │
│ MCP服务器 │
└────┬──────┬─────┘
│ │
▼ ▼
┌─────────┐ ┌─────────┐
│ MILVUS │ │ Ollama │
│ :19530 │ │ :11434 │
└─────────┘ └─────────┘
🛠️ 手动设置
如果您希望手动设置服务：
- MILVUS：请参阅docs/MILVUS_SETUP.md
- Ollama：请参阅docs/OLLAMA_SETUP.md
- VS Code：请参阅VSCODE_SETUP.md
🔄 管理服务
启动服务
docker-compose up -d
停止服务
docker-compose down
查看日志
docker-compose logs -f
重启服务
docker-compose restart
📊 资源使用
预期资源消耗：
- MILVUS：约2GB内存，约1GB磁盘（随索引数据变化）
- Ollama：约2-4GB内存（取决于模型），约1.5GB磁盘
- 总计：约4-6GB内存，至少2-3GB磁盘
🧹 清理
要删除所有服务和数据：
Windows:
.\cleanup-windows.ps1
Linux/Mac:
./cleanup-linux.sh
这将：
- 停止所有容器
- 删除容器和卷
- 清理下载的模型（可选）
⚙️ 配置
MCP服务器使用这些环境变量：
{
"EMBEDDING_PROVIDER": "Ollama",
"MILVUS_ADDRESS": "127.0.0.1:19530",
"OLLAMA_HOST": "http://127.0.0.1:11434",
"OLLAMA_MODEL": "nomic-embed-text"
}
对于高级配置选项，请参阅docs/CONFIGURATION.md。
🐛 故障排除
服务无法启动
# 检查端口是否已被占用
netstat -an | grep -E "(19530|11434)" # Linux
netstat -an | findstr "19530 11434" # Windows
Ollama模型未找到
docker exec -it ollama ollama list
docker exec -it ollama ollama pull nomic-embed-text
MILVUS连接失败
docker-compose logs milvus
docker-compose restart milvus
更多解决方案，请参阅docs/TROUBLESHOOTING.md。
🤝 贡献
此设置基于官方claude-context项目。关于MCP服务器本身的问题，请参阅上游仓库。
📄 许可
此设置仓库按原样提供，用于教育和开发目的。请参阅原始MCP服务器许可。