Synapse MCP

🚀 Synapse MCP サーバーガイド

Synapse MCPサーバーは、特定の機能を提供するサーバーです。このガイドでは、そのインストール、設定、使用方法、デプロイ方法などについて説明します。

🚀 クイックスタート

Synapse MCPサーバーを使用するには、まずインストールと設定を行う必要があります。以下の手順に従って進めてください。

📦 インストール

リポジトリのクローンと依存関係のインストール

1. ターミナルを開き、以下のコマンドを実行してリポジトリをクローンします。

git clone https://github.com/susheel/synapse-mcp.git
cd synapse-mcp

2. 仮想環境を作成し、アクティブ化します。

   • Linux/Mac:

   python -m venv .venv
   source .venv/bin/activate
   

   • Windows:

   python -m venv .venv
   .\.venv\Scripts\activate
   

3. 依存関係をインストールします。

pip install -e .

Claude Desktopの設定

1. Claude Desktopを開き、メニューバーの「Claude」 -> 「Settings...」をクリックします。
2. 左側で「Developer」を選択し、「Edit Config」をクリックします。
3. mcpServers ノードに以下の設定を追加します。

"synapse-mcp": {
  "command": "python",
  "args": [
    "/path/to/synapse-mcp/server.py",
    "--host", "127.0.0.1",
    "--port", "9000"
  ]
}

4. 設定ファイルを保存し、Claude Desktopを再起動します。

💻 使用例

エンティティ情報の取得

• 例のクエリ：Get the entity with ID syn123456 from Synapse

プロジェクトデータのクエリ

• 例のクエリ：Query all files in the Synapse project syn123456

注釈情報の取得

• 例のクエリ：Get annotations for the Synapse entity syn123456

📚 デプロイガイド

Dockerによるデプロイ

イメージのビルド

docker build -t synapse-mcp .

コンテナの実行

# OAuth設定で実行
docker run -p 9000:9000 -e SYNAPSE_OAUTH_CLIENT_ID=your_client_id -e SYNAPSE_OAUTH_CLIENT_SECRET=your_client_secret -e SYNAPSE_OAUTH_REDIRECT_URI=your_redirect_uri synapse-mcp

# SSEモードで実行
docker run -p 9000:9000 -e MCP_TRANSPORT=sse -e MCP_SERVER_URL=mcp://your-domain:9000 synapse-mcp

Fly.ioによるデプロイ

flyctlのインストールと設定

curl -L https://fly.io/install.sh | sh
flyctl auth login

アプリの公開

flyctl launch

シークレットの設定

flyctl secrets set SYNAPSE_OAUTH_CLIENT_ID=your_client_id
flyctl secrets set SYNAPSE_OAUTH_CLIENT_SECRET=your_client_secret
flyctl secrets set SYNAPSE_OAUTH_REDIRECT_URI=https://your-app-name.fly.dev/oauth/callback
flyctl secrets set MCP_TRANSPORT=sse
flyctl secrets set MCP_SERVER_URL=mcp://your-app-name.fly.dev:9000

デプロイ

flyctl deploy

✨ 貢献ガイド

貢献いただけることを歓迎します！自由にPull Requestを送信してください。

📄 ライセンス

MIT License