Sourcesyncai MCP

🚀 SourceSync.ai MCP 服務器配置指南

本指南將詳細介紹如何安裝、配置和使用 SourceSync.ai 的 MCP 服務器，幫助您將其順利集成到項目中。

🚀 快速開始

安裝要求

• Node.js 版本 >= 14.0.0
• npm 版本 >= 6.0.0
• 具有寫入權限的目錄用於存儲數據和日誌

下載源代碼

git clone https://github.com/sourcesyncai/mcp.git
cd mcp

安裝依賴

npm install

啟動服務器

node dist/index.js

✨ 主要特性

• 提供文檔管理工具，支持文檔的獲取、創建和更新操作。
• 支持數據源同步，可創建數據源連接並同步數據。
• 具備文檔內容檢索工作流程，方便獲取文檔實際內容。

📦 安裝指南

安裝要求

• Node.js 版本 >= 14.0.0
• npm 版本 >= 6.0.0
• 具有寫入權限的目錄用於存儲數據和日誌

下載源代碼

git clone https://github.com/sourcesyncai/mcp.git
cd mcp

安裝依賴

npm install

啟動服務器

node dist/index.js

💻 使用示例

基礎用法

文檔管理工具

• 獲取文檔

{
  "name": "getDocuments",
  "arguments": {
    "namespaceId": "your_namespace_id",
    "query": "*",
    "filter": {},
    "sort": {},
    "page": 1,
    "perPage": 10,
    "tenantId": "tenant_XXX"
  }
}

• 創建文檔

{
  "name": "createDocument",
  "arguments": {
    "namespaceId": "your_namespace_id", 
    "title": "Example Document",
    "content": "This is an example document.",
    "tenantId": "tenant_XXX"
  }
}

• 更新文檔

{
  "name": "updateDocument",
  "arguments": {
    "namespaceId": "your_namespace_id", 
    "documentId": "doc_123456789",
    "title": "Updated Document",
    "content": "This is an updated example document.",
    "tenantId": "tenant_XXX"
  }
}

數據源同步

• 創建數據源連接

{
  "name": "create_connection", 
  "arguments": {
    "tenantId": "tenant_XXX",
    "namespaceId": "namespace_XXX",
    "name": "My Connection",
    "connector": "GOOGLE_DRIVE",
    "clientRedirectUrl": "https://your-app.com/callback"
  }
}

• 同步數據

{
  "name": "sourceSync", 
  "arguments": {
    "tenantId": "tenant_XXX",
    "namespaceId": "namespace_XXX",
    "sourceConfig": {
      "connector": "GOOGLE_DRIVE",
      "config": {
        "path": "/my/drive/path"
      }
    }
  }
}

文檔內容檢索工作流程

1. 首先使用 getDocuments 並設置 includeConfig.parsedTextFileUrl: true 來獲取文檔及其內容 URL
2. 從文檔響應中提取 URL
3. 使用 fetchUrlContent 來獲取實際內容：

{
  "name": "fetchUrlContent",
  "arguments": {
    "url": "https://example.com"
  }
}

高級用法

創建 MCP 實例

const MCP = require('sourcesyncai-mcp');
const mcp = new MCP({
  port: 3000,
  baseUrl: '/api',
  debug: true
});
mcp.start();

發送請求

async function sendRequest() {
  try {
    const response = await fetch('http://localhost:3000/api/document', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        "name": "createDocument",
        "arguments": {
          "namespaceId": "your_namespace_id", 
          "title": "New Document",
          "content": "This is a new document.",
          "tenantId": "tenant_XXX"
        }
      })
    });
    const data = await response.json();
    console.log(data);
  } catch (error) {
    console.error(error);
  }
}
sendRequest();

📚 詳細文檔

配置 MCP 服務器

環境變量配置

編輯 config/default.json 文件，設置以下參數：

• PORT: 服務監聽端口，默認值為3000。
• BASE_URL: 服務基礎路徑，默認值為/api.
• DEBUG: 是否啟用調試模式，默認值為false。

日誌文件

日誌文件默認存儲在 log/output.log，可通過修改 config/logger.json 配置日誌輸出位置和格式。

示例提示

以下是可用於 Claude 或 Cursor 的一些示例提示（在配置 MCP 服務器後）：

• "搜索我的 SourceSync 知識庫以獲取關於機器學習的信息。"
• "將此文章 ingest 到我的 SourceSync 知識庫中：[URL]"
• "為我的項目文檔創建一個新的命名空間。"
• "列出我 SourceSync 命名空間中的所有文檔。"
• "獲取我 SourceSync 命名空間中 [document_id] 文檔的文本內容。"

故障排除

連接問題

如果遇到連接 SourceSync.ai MCP 服務器的問題：

1. 驗證路徑：確保配置中的所有路徑都是絕對路徑，而不是相對路徑。
2. 檢查權限：確保服務器文件有執行權限（chmod +x dist/index.js）。
3. 啟用開發者模式：在 Claude 桌面中啟用開發者模式並檢查 MCP 日誌文件。
4. 測試服務器：直接從命令行運行服務器：

node /path/to/sourcesyncai-mcp/dist/index.js

5. 重啟 AI 客戶端：在進行更改後，完全重啟 Claude 桌面或 Cursor。
6. 檢查環境變量：確保所有必需的環境變量已正確設置。

日誌文件

日誌默認存儲在 log/output.log。可以通過修改 config/logger.json 配置日誌輸出位置和格式。

🔧 技術細節

安裝要求的技術原因

• Node.js 版本 >= 14.0.0：確保服務器能夠支持項目所需的新特性和性能優化。
• npm 版本 >= 6.0.0：保證依賴的正確安裝和管理。
• 具有寫入權限的目錄：用於存儲數據和日誌，確保服務器正常運行。

環境變量配置的作用

• PORT：指定服務監聽的端口，方便在不同環境中部署。
• BASE_URL：設置服務的基礎路徑，便於與其他服務集成。
• DEBUG：啟用調試模式，方便開發和排查問題。

📄 許可證

文檔中未提及相關許可證信息。

項目地址

• SourceSync.ai GitHub 倉庫
• 官方文檔

通過以上步驟，您可以順利配置和運行 SourceSync.ai 的 MCP 服務器，並集成到您的項目中。