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 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://gips1.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

联系

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