Synapse MCP 服务器

这是一个模型上下文协议（MCP）服务器，使AI代理能够访问Synapse实体（数据集、项目、文件夹、文件、表格等）。

你可以（你的AI代理可以）：

• 根据ID检索实体
• 获取实体注释
• 列出实体子项
• 使用路径和类型过滤器搜索Synapse实体
• 检查实体版本记录的来源/活动

可用工具

工具	友好名称	描述
get_entity(entity_id)	获取实体	根据ID获取Synapse实体的核心元数据。
get_entity_annotations(entity_id)	获取实体注释	返回与实体关联的自定义注释。
get_entity_provenance(entity_id, version=None)	获取实体来源	获取实体的来源（活动）元数据，可选地限定于特定版本。
get_entity_children(entity_id)	列出实体子项	列出容器实体（如项目和文件夹）的子项。
search_synapse(query_term=None, ...)	搜索Synapse	根据关键词搜索Synapse实体，并可选地使用名称/类型/父级过滤器。结果由Synapse作为数据托管者提供；归属和许可遵循源实体的元数据。

可用资源

资源提供了客户端可以直接拉取而无需额外参数的现成上下文。当你需要搜索或计算派生结果时，请优先使用工具。

资源	友好名称	描述
synapse://feeds/blog	Sage Blog RSS	最新的Sage Bionetworks发布文章的实时RSS XML。

⚠️ 服务条款合规通知

重要： 当您使用此MCP服务器与外部AI服务（如Claude、ChatGPT或其他基于云的模型）结合时，请注意：

• 您将使用个人的Synapse访问令牌来检索数据
• 发送到外部AI服务的数据可能会被存储、记录或用于模型训练
• Synapse的服务条款禁止重新分发数据，这可能包括第三方AI提供商的存储或使用

推荐安全使用方式：

• ✅ 与具有数据驻留保证的企业AI部署一起使用
• ✅ 与本地/自托管的AI模型一起使用
• ✅ 如果提供，利用负责任的AI使用培训
• ❌ 避免与可能存储或训练您的数据的消费者AI服务一起使用

您有责任确保您的使用符合Synapse服务条款。

使用方法

本指南提供了连接到Synapse MCP服务器的典型用户说明。对于贡献者设置，请参阅DEVELOPMENT.md。

配置

环境选择

您可以设置SYNAPSE_ENV环境变量来配置要连接的Synapse平台实例：

• prod（默认） - 生产实例在synapse.org
• staging - 测试实例在staging.synapse.org
• dev - 开发实例在dev.synapse.org

如果没有设置，默认为prod。

认证

Synapse MCP服务器支持两种认证方法：

1. OAuth2（默认）： 这是主要且推荐的认证方法。它提供了一个安全的基于浏览器的登录流程。当您的AI代理需要访问受保护的资源时，它会提示您在浏览器中登录Synapse。此方法默认用于本地和远程服务器。

2. 个人访问令牌（PAT）： 此方法适用于本地开发或在无法进行基于浏览器登录的环境中。它要求您向服务器提供Synapse个人访问令牌。

MCP服务器设置

远程服务器

在您的客户端中使用此URL： 🔌 https://mcp.synapse.org/mcp

Claude桌面指令

前往设置 > 连接器 > 添加自定义连接器

<img width="664" height="146" alt="image" src="https://gips0.baidu.com/it/u=2818142191,3830054210&fm=3081&app=3081&f=PNG?w=1328&h=292" />

Claude代码

claude mcp add --transport http synapse -- https://mcp.synapse.org/mcp

本地服务器

有关运行本地服务器的信息，请参阅DEVELOPMENT.md

示例提示

参见使用示例

贡献

欢迎贡献！请参阅我们的开发指南，了解如何设置开发环境、运行测试等内容。

许可证

MIT

联系

如有问题，请提交一个issue。其他联系方式，请访问https://sagebionetworks.org/contact。