MCP Code Context

Claude Context MCP-本地设置

一个独立的设置，用于运行 claude上下文MCP服务器 使用Docker容器的本地服务。

🎯 概述

此存储库提供了Claude Context MCP服务器的完全本地部署，包括：

• 密尔乌斯 -用于存储嵌入的本地向量数据库
• 奥拉玛 -局部嵌入模型推理
• 码头工人 -容器化服务，便于设置

✨ 特性

• 🔒 完全本地化 -无云依赖，所有数据都保留在您的计算机上
• 🚀 一个命令设置 -Windows和Linux的自动化脚本
• 🐳 基于Docker -跨平台的一致环境
• 📦 独立 -您需要的一切都在一个存储库中

📋 先决条件

在开始之前，请确保您已经：

• 码头工人 和 Docker Compose 安装
• Node.js （>=20.0.0和\<24.0.0）
• VS Code （用于MCP集成）
• 至少 8GB内存 适用于Docker容器
• 至少 4GB磁盘空间 用于模型和数据库

🏢 企业代理/防火墙用户

⚠️ 重要提示： 如果您使用的是公司代理（例如Cisco Umbrella、Zscaler），则需要在运行安装程序之前添加CA证书。

快速步骤：

1. 导出组织的根CA证书
2. 把它放进去 ollama/res/Cisco_Umbrella_Root_CA.cer
3. 运行安装脚本（它将自动使用您的证书进行构建）

📖 看 公司简介\_ PROXY_SETUP.md 获取完整的分步说明。

如果你 不 在公司代理后面，跳过此步骤-默认设置将正常工作。

安装Docker

窗户：

• 下载并安装
• 确保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

窗户：

• 下载自 （LTS版本20.x或22.x）

Linux：

# Using nvm (recommended)
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

这将：

1. 在Docker中启动MILVUS数据库
2. 在Docker中启动Ollama服务
3. 下载 nomic-embed-text 嵌入模型
4. 验证所有服务是否正在运行

3.配置VS代码

按照中的说明进行操作 VSCODE_SETUP.md 将MCP服务器添加到VS代码中。

4.验证设置

窗户：

.\verify-setup.ps1

Linux/Mac：

chmod +x verify-setup.sh
./verify-setup.sh

这将检查所有服务是否正常运行。

5.开始使用

看 用法.md 有关索引代码库和使用MCP服务器的详细说明。

检查 示例.md 用于实际示例和现实世界用例。

📚 文档

入门指南

• 快速参考 -快速命令和快捷方式
• VS代码设置 -VS代码中的MCP服务器配置
• 使用指南 -如何使用MCP服务器
• 例子 -实例和用例
• 公司代理设置 -在公司防火墙后进行设置

详细指南

• MILVUS设置 -详细的MILVUS配置
• Ollama设置 -Ollama详细配置
• 配置 -高级配置选项
• 故障排除 -常见问题和解决方案

贡献

• 贡献指南 -如何为这个项目做出贡献

🔧 建筑

┌─────────────────┐
│   VS Code       │
│  (MCP Client)   │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  Claude Context │
│   MCP Server    │
└────┬──────┬─────┘
     │      │
     ▼      ▼
┌─────────┐ ┌─────────┐
│ MILVUS  │ │ Ollama  │
│ :19530  │ │ :11434  │
└─────────┘ └─────────┘

🛠️ 手动设置

如果您更喜欢手动设置服务：

1. 密尔乌斯：参见 docs/MILVUS_SETUP.md
2. 奥拉玛：参见 docs/OLLAMA_SETUP.md
3. VS Code：参见 VSCODE_SETUP.md

🔄 管理服务

启动服务

docker-compose up -d

停止服务

docker-compose down

查看日志

docker-compose logs -f

重新启动服务

docker-compose restart

📊 资源使用情况

预计资源消耗：

• 密尔乌斯：~2GB RAM，~1GB磁盘（因索引数据而异）
• 奥拉玛：~2-4GB RAM（取决于型号），~1.5GB磁盘
• 总计：~4-6GB RAM，最小~2-3GB磁盘

🧹 清理

要删除所有服务和数据：

窗户：

.\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.

🐛 故障排除

服务无法启动

# Check if ports are already in use
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.

🤝 贡献

此设置基于官方 克劳德语境 项目。有关MCP服务器本身的问题，请参阅上游存储库。

📄 许可证

此设置存储库按原样提供，用于教育和开发目的。请参考原件 claude上下文许可证 对于MCP服务器。

🔗 链接

• MILVUS文件
• Ollama文件
• MCP协议