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