MCP Context Provider

🚀 MCP上下文提供者

MCP上下文提供者是一个静态的MCP（模型上下文协议）服务器，它为AI模型提供持久的工具上下文，防止在聊天会话之间丢失上下文。该服务器会在Claude Desktop启动时自动加载并注入特定工具的规则、语法偏好和最佳实践。

🚀 快速开始

选项1：自动安装（推荐）

使用提供的安装脚本安装MCP上下文提供者是最简单的方法：

Unix/Linux/macOS：

# 下载DXT包
wget https://github.com/doobidoo/MCP-Context-Provider/raw/main/mcp-context-provider-1.1.0.dxt

# 运行安装脚本
curl -sSL https://raw.githubusercontent.com/doobidoo/MCP-Context-Provider/main/install.sh | bash

Windows：

# 下载并运行Windows安装程序
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/doobidoo/MCP-Context-Provider/main/install.bat" -OutFile "install.bat"
.\install.bat

安装脚本会自动执行以下操作：

• 解压DXT扩展
• 创建Python虚拟环境
• 安装所有必需的依赖项
• 配置Claude Desktop设置

选项2：从DXT手动安装

# 安装DXT CLI（如果尚未安装）
npm install -g @anthropic-ai/dxt

# 下载DXT包
wget https://github.com/doobidoo/MCP-Context-Provider/raw/main/mcp-context-provider-1.1.0.dxt

# 将扩展解压到您想要的位置
dxt unpack mcp-context-provider-1.1.0.dxt ~/mcp-context-provider

# 导航到安装目录
cd ~/mcp-context-provider

# 创建并激活Python虚拟环境
python -m venv venv
source venv/bin/activate  # 在Windows上：venv\Scripts\activate

# 安装依赖项
pip install mcp>=1.9.4

选项3：从源代码安装

# 克隆仓库
git clone https://github.com/doobidoo/MCP-Context-Provider.git
cd MCP-Context-Provider

# 创建并激活Python虚拟环境
python -m venv venv
source venv/bin/activate  # 在Windows上：venv\Scripts\activate

# 安装依赖项
pip install -r requirements.txt

2. 配置

更新您的Claude Desktop配置文件：

配置文件位置：

• Linux/Mac：~/.config/claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

对于虚拟环境安装（推荐）：

{
  "mcpServers": {
    "context-provider": {
      "command": "/path/to/mcp-context-provider/venv/bin/python",
      "args": ["/path/to/mcp-context-provider/context_provider_server.py"],
      "env": {
        "CONTEXT_CONFIG_DIR": "/path/to/mcp-context-provider/contexts",
        "AUTO_LOAD_CONTEXTS": "true"
      }
    }
  }
}

对于系统Python安装：

{
  "mcpServers": {
    "context-provider": {
      "command": "python",
      "args": ["context_provider_server.py"],
      "cwd": "/path/to/MCP-Context-Provider",
      "env": {
        "CONTEXT_CONFIG_DIR": "./contexts",
        "AUTO_LOAD_CONTEXTS": "true"
      }
    }
  }
}

重要提示：请将/path/to/mcp-context-provider替换为实际的安装路径。

3. 验证安装

运行验证脚本来确保一切配置正确：

python verify_install.py

4. 重启Claude Desktop

更新配置后，重启Claude Desktop以加载MCP服务器。

✨ 主要特性

上下文提供者在您的AI交互中充当持久的神经核心，通过以下方式消除在每个新聊天会话中重新建立上下文的需求：

• 🔄 持久上下文：就像可视化中的稳定球体一样，规则和偏好可以在Claude Desktop重启后仍然保留。
• ⚡ 自动注入：上下文可以无缝地融入每个对话，就像数据流连接到中心核心一样。
• 🎯 特定工具：每个工具都有自己的上下文规则和语法偏好，创建专门的知识路径。
• 🔧 自动校正：自动语法转换（例如，Markdown → DokuWiki）确保所有交互的一致性。
• 📈 可扩展：易于添加新工具和上下文规则，扩展知识网络。
• 🏢 企业就绪：版本控制的上下文管理提供组织稳定性。

🔧 神经网络隐喻

就像图片所描绘的那样，您的MCP上下文提供者的功能如下：

• 中心球体：稳定、持久的上下文核心，保持一致性。
• 神经通路：特定工具的上下文规则，创建专门的知识通道。
• 数据流：各个聊天会话，通过并受益于持久上下文。
• 网络稳定性：防止对话的短暂性导致重要上下文信息丢失。

💻 使用示例

基础用法

以下是使用MCP上下文提供者的一些示例：

DokuWiki语法转换

输入（Markdown）：

# My Header
This is `inline code` and here's a [link](http://example.com).

自动转换为DokuWiki：

====== My Header ======
This is ''inline code'' and here's a [[http://example.com|link]].

Azure资源命名

输入：storage_account_logs_prod 自动校正为：stlogsprod（遵循Azure命名约定）

Git提交消息

输入：Fixed the login bug 自动校正为：fix: resolve login authentication issue

高级用法

自定义上下文规则

通过遵循既定模式创建您自己的上下文文件。服务器支持：

• 基于正则表达式的自动校正
• 特定工具的偏好
• 条件格式化规则
• 多工具上下文继承

特定环境上下文

使用环境变量加载不同的上下文集：

{
  "env": {
    "CONTEXT_CONFIG_DIR": "./contexts/production",
    "ENVIRONMENT": "prod"
  }
}

📚 详细文档

工作原理

架构

1. 上下文提供者服务器：Python MCP服务器，用于加载JSON上下文文件。
2. 上下文文件：特定工具的规则存储在/contexts目录中。
3. Claude Desktop集成：MCP服务器在配置中注册。
4. 自动加载：上下文在启动时注入，并在聊天过程中持久存在。

上下文流程

启动 → 加载上下文文件 → 注册MCP工具 → 所有聊天中均可使用上下文

可用工具

加载后，以下工具可在所有聊天会话中使用：

• get_tool_context：获取特定工具的上下文规则。
• get_syntax_rules：获取语法转换规则。
• list_available_contexts：列出所有已加载的上下文类别。
• apply_auto_corrections：应用自动语法校正。

上下文文件

服务器从/contexts目录加载上下文文件：

• dokuwiki_context.json：DokuWiki语法规则和偏好。
• terraform_context.json：Terraform命名约定和最佳实践。
• azure_context.json：Azure资源命名和合规规则。
• git_context.json：Git提交约定和工作流模式。
• general_preferences.json：跨工具偏好和标准。

上下文文件结构

每个上下文文件遵循以下模式：

{
  "tool_category": "toolname",
  "description": "Tool-specific context rules",
  "auto_convert": true,
  "syntax_rules": {
    "format_rules": "conversion patterns"
  },
  "preferences": {
    "user_preferences": "settings"
  },
  "auto_corrections": {
    "regex_patterns": "automatic fixes"
  },
  "metadata": {
    "version": "1.0.0",
    "applies_to_tools": ["tool:*"]
  }
}

📄 许可证

本项目采用MIT许可证，请参阅LICENSE文件以获取详细信息。

📦 添加新上下文

要添加对新工具的支持，请执行以下操作：

1. 创建一个新的JSON文件：contexts/{toolname}_context.json。
2. 遵循标准上下文结构。
3. 重启Claude Desktop以加载新上下文。

服务器会自动检测并加载上下文目录中的任何*_context.json文件。

📈 好处

对于开发者

• 无需在新聊天中重新建立上下文。
• 自动语法校正节省时间。
• 所有工作中的格式一致。
• 自动应用最佳实践。

对于团队

• 团队成员之间共享上下文规则。
• 版本控制的标准。
• 一致的代码和文档格式。
• 自动执行企业合规性。

对于组织

• 集中式上下文管理。
• 可跨多个工具扩展。
• 上下文更改的审计跟踪。
• 易于部署和更新。

🛠️ 故障排除

常见问题

1. 上下文未加载：检查Claude Desktop配置中的文件路径。
2. 服务器未启动：验证Python依赖项是否已安装。
3. 规则未应用：检查上下文文件中的JSON语法。

有关详细解决方案，请参阅TROUBLESHOOTING.md。

📚 文档

• 上下文指南：完整的上下文文件参考。
• 开发者指南：创建自定义上下文。
• 示例：实际使用示例。
• 故障排除：常见问题和解决方案。

📦 DXT包分发

MCP上下文提供者作为桌面扩展（DXT）包提供，便于分发和安装：

• 包：mcp-context-provider-1.0.0.dxt（18.6 MB）
• 内容：包含所有依赖项的完整服务器。
• 平台：支持Python 3.8+的Windows、macOS、Linux。
• 依赖项：自包含（无需外部pip要求）。

构建DXT包

要从源代码构建您自己的DXT包，请执行以下操作：

# 安装DXT CLI
npm install -g @anthropic-ai/dxt

# 构建包
cd dxt
dxt pack

# 包将创建为mcp-context-provider-1.0.0.dxt

分发说明

• DXT包包含所有Python依赖项（MCP SDK、Pydantic等）。
• 总解压大小：包括所有依赖项约为45 MB。
• 针对离线安装和部署进行了优化。
• 与企业环境和隔离网络系统兼容。

🤝 贡献

1. 分叉仓库。
2. 创建一个功能分支：git checkout -b feature/new-context。
3. 将您的上下文文件添加到/contexts。
4. 使用您的Claude Desktop设置进行测试。
5. 提交拉取请求。