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

💻 使用例

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 サーバーを構成した後に Claude または Cursor で使用できるサンプルプロンプトです。

• "SourceSync の知識ベースを検索して、機械学習に関する情報を取得します。"
• "この記事を SourceSync の知識ベースに ingest します: [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 を変更することで、ログの出力先と形式を設定できます。

🔗 リンク

• SourceSync.ai GitHub リポジトリ
• 公式ドキュメント

以上の手順に従うことで、SourceSync.ai の MCP サーバーを正常に構成し、プロジェクトに統合することができます。