Ibproduct Ib MCP Cache Server

🚀 內存緩存服務器

內存緩存服務器是一個模型上下文協議（MCP）服務器，它能夠在語言模型交互過程中高效緩存數據，從而減少代幣消耗。該服務器與任何MCP客戶端以及使用令牌的任何語言模型都兼容。

🚀 快速開始

安裝

按照以下步驟安裝內存緩存服務器：

1. 克隆倉庫：

git clone git@github.com:ibproduct/ib-mcp-cache-server
cd ib-mcp-cache-server

2. 安裝依賴項：

npm install

3. 構建項目：

npm run build

4. 添加到您的MCP客戶端設置中：

{
  "mcpServers": {
    "memory-cache": {
      "command": "node",
      "args": ["/path/to/ib-mcp-cache-server/build/index.js"]
    }
  }
}

5. 啟用MCP客戶端時，服務器會自動啟動。

驗證運行正常

當服務器正常運行時，您會在終端看到以下情況：

1. 消息：“內存緩存MCP服務器在stdio上運行”
2. 訪問相同數據多次時性能提升
3. 響應更快，尤其是對於重複操作

✨ 主要特性

減少代幣消耗

服務器通過以下方式減少代幣消耗：

1. 自動緩存：所有響應都會被自動緩存，除非設置了Cache-Control: no-cache頭。
2. 過期機制：緩存條目會在設置的時間後自動失效。
3. 命中率統計：服務器會跟蹤緩存命中次數，並顯示在控制檯。

自動緩存管理

1. 服務器啟動時會加載配置文件並初始化緩存。
2. 定期檢查緩存空間使用情況，超過限制時自動清理。
3. 支持設置最大內存佔用，避免影響系統性能。

📦 安裝指南

安裝步驟

1. 克隆倉庫：

git clone git@github.com:ibproduct/ib-mcp-cache-server
cd ib-mcp-cache-server

2. 安裝依賴項：

npm install

3. 構建項目：

npm run build

4. 添加到MCP客戶端設置：

{
  "mcpServers": {
    "memory-cache": {
      "command": "node",
      "args": ["/path/to/ib-mcp-cache-server/build/index.js"]
    }
  }
}

5. 啟用MCP客戶端，服務器自動啟動。

📚 詳細文檔

配置說明

所有配置參數如下：

如何減少代幣消耗

服務器通過自動緩存、過期機制和命中率統計來減少代幣消耗。

自動緩存管理

服務器啟動時加載配置文件並初始化緩存，定期檢查緩存空間，支持設置最大內存佔用。

優化技巧

• 調整條目數：根據項目需求增加MAX_ENTRIES以提高命中率。
• 延長有效期：適當增加DEFAULT_TTL可以減少緩存失效次數。
• 監控使用情況：定期檢查命中率和緩存大小，確保最佳性能。

環境變量配置

可以在MCP客戶端中設置環境變量覆蓋默認值：

{
  "mcpServers": {
    "memory-cache": {
      "command": "node",
      "args": ["/path/to/build/index.js"],
      "env": {
        "MAX_ENTRIES": "5000",
        "MAX_MEMORY": "209715200",  // 200MB
        "DEFAULT_TTL": "7200",      // 2 hours
        "CHECK_INTERVAL": "120000",  // 2 minutes
        "STATS_INTERVAL": "60000"    // 1 minute
      }
    }
  }
}

您也可以指定一個自定義的配置文件路徑：

{
  "env": {
    "CONFIG_PATH": "/path/to/your/config.json"
  }
}

服務器將：

1. 在其目錄中查找默認配置文件
2. 應用任何環境變量覆蓋
3. 如果未指定，則使用默認值

實際測試緩存效果

要觀察緩存的實際效果，請嘗試以下場景：

1. 文件讀取測試
   • 讀取並分析一個大文件
   • 再次詢問相同的問題
   • 第二次響應應該更快，因為文件內容已緩存
2. 數據分析測試
   • 執行一些數據分析
   • 再次請求相同的分析
   • 第二次分析將使用緩存結果
3. 項目導航測試
   • 探索項目的結構
   • 再次查詢相同的文件/目錄
   • 目錄列表和文件內容將從緩存中提供

緩存正常工作時，您會注意到：

• 重複操作的響應速度更快
• 對未更改內容的答案一致
• 不需要重新讀取未更改的文件