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