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

✨ 主要特性

本服务器提供了文档管理、数据源同步和文档内容检索等功能，能有效帮助用户管理和同步数据。

📦 安装指南

⚙️ 配置 MCP 服务器

🌐 环境变量配置

编辑 config/default.json 文件，设置以下参数：

• PORT：服务监听端口，默认值为 3000。
• BASE_URL：服务基础路径，默认值为 /api。
• DEBUG：是否启用调试模式，默认值为 false。

📄 日志文件

日志文件默认存储在 log/output.log，可通过修改 config/logger.json 配置日志输出位置和格式。

💻 使用示例

🛠️ 工具说明

📃 文档管理工具

📥 获取文档

{
  "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"
  }
}

💡 示例提示

以下是可用于 Claude 或 Cursor 的一些示例提示（在配置 MCP 服务器后）：

• "搜索我的 SourceSync 知识库以获取关于机器学习的信息。"
• "将此文章 ingest 到我的 SourceSync 知识库中：[URL]"
• "为我的项目文档创建一个新的命名空间。"
• "列出我 SourceSync 命名空间中的所有文档。"
• "获取我 SourceSync 命名空间中 [document_id] 文档的文本内容。"

🚩 代码示例

🆕 创建 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();

📚 详细文档

❓ 故障排除

🔌 连接问题

如果遇到连接 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 配置日志输出位置和格式。

🔗 项目地址

• SourceSync.ai GitHub 仓库
• 官方文档

通过以上步骤，您可以顺利配置和运行 SourceSync.ai 的 MCP 服务器，并集成到您的项目中。