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. 提交拉取請求。