MCP Thought Server

🚀 MCP 思考服務器使用說明

MCP 思考服務器是一個強大的工具，能幫助用戶高效處理思考相關任務。本說明將詳細介紹其安裝、運行、錯誤處理等方面的內容。

🚀 快速開始

安裝與運行

1. 安裝依賴

在項目的根目錄下運行以下命令以安裝所有必要的依賴：

npm install

2. 運行服務器

啟動服務器有三種常用方式：

• 方式一：使用 npx 啟動 直接運行以下命令即可啟動服務器：

npx ts-node src/index.ts

• 方式二：構建並啟動 先構建項目，然後啟動構建後的文件：

npm run build
npm start

• 方式三：使用 Docker 容器啟動（參見下方 Docker 支持部分）

3. 配置環境變量

以下是服務器運行所需的環境變量及其說明：

❗ 錯誤處理與常見問題

1. "Original draft X not found" 錯誤

此錯誤表明無法檢索到之前的草稿記錄。請確保以下幾點：

• 數據庫文件路徑（通過 MCP_SQLITE_PATH 或默認路徑 data/mcp-thought-server.sqlite）正確無誤。
• 服務器進程對數據庫文件所在的目錄和文件具有寫入權限。
• 如果懷疑數據庫文件損壞，可以嘗試刪除舊的 .sqlite 文件以重建新的空數據庫。但請注意，此操作會導致歷史數據丟失。

2. LLM 連貫性檢查問題

若啟用連貫性檢查，請確保以下配置正確：

• COHERENCE_API_KEY：包含有效的 API 密鑰。
• COHERENCE_CHECK_MODEL：指定支持結構化 JSON 輸出的模型 ID。
• 確保外部 LLM 服務運行正常。 如需禁用連貫性檢查，可刪除或註釋相關環境變量配置。

3. 低置信度評分

可能的原因包括：

• AI 的輸出內容與上下文語義不匹配（檢查語義相似度評分部分）。
• 啟用了連貫性檢查但模型輸出不連貫。
• 提供給工具的 context 參數不足或定義模糊。

4. 嵌入式模型下載失敗

請確保首次運行服務器時具備互聯網連接，以便下載必要的嵌入式模型。同時檢查緩存目錄權限：

npm run download-models

🔧 技術細節

MCP 思考服務器基於以下主要組件構建：

• 輸入處理模塊：負責接收和解析用戶請求。
• 上下文管理器：維護當前思考過程的上下文信息。
• 推理引擎：根據上下文生成思考結果並評估置信度。
• 輸出適配器：將推理結果格式化為指定輸出格式。

🐳 Docker 支持

1. 構建鏡像

在項目根目錄下運行以下命令以構建 Docker 鏡像：

docker build -t mcp-thought-server .

2. 運行容器

• 基本啟動

docker run --name mcp-thought-container -it mcp-thought-server

• 配置環境變量並綁定端口

docker run --name mcp-thought-container \
    -e LOG_LEVEL=info \
    -e TRANSPORT=http \
    -p 3000:3000 \
    -it mcp-thought-server

3. 停止與刪除容器

• 停止運行中的容器：

docker stop mcp-thought-container

• 刪除已停止的容器：

docker rm mcp-thought-container

📄 附錄：環境變量參考

如有其他問題或需要進一步幫助，請隨時查閱項目文檔或聯繫維護團隊。