使用说明
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 博客 RSS | Sage Bionetworks 最新发布文章的实时 RSS XML。 |
⚠️ 服务条款合规通知
重要提示： 当使用此MCP服务器与外部AI服务（如Claude、ChatGPT或其他基于云的模型）时，请注意：
- 您将使用您的个人Synapse访问令牌来检索数据
- 发送给外部AI服务的数据可能会被存储、记录或用于模型训练
- Synapse服务条款禁止数据的重新分发，这可能包括由第三方人工智能提供商进行的存储或使用
推荐的安全使用方法：
- ✅ 适用于具有数据本地化保证的企业级AI部署
- ✅ 与本地/自托管AI模型配合使用
- ✅ 如有提供，请利用负责任的人工智能使用培训
- ❌ 避免与可能存储或基于您的数据进行训练的消费者AI服务一起使用
您有责任确保您的使用符合（相关规定/条款） Synapse服务条款。
用法
本指南提供了连接到Synapse MCP服务器的典型用户操作说明。如需设置贡献者权限，请参阅 DEVELOPMENT.md 翻译为中文是：开发指南/开发说明.md。
认证
Synapse MCP服务器支持两种认证方法：
-
OAuth2（默认）： 这是主要且推荐的认证方法。它提供了一种基于浏览器的安全登录流程。当您的AI代理需要访问受保护资源时，它会提示您在浏览器中登录Synapse。此方法默认适用于本地和远程服务器。
-
个人访问令牌（PAT）： 这种方法适用于本地开发或在无法使用基于浏览器的登录的环境中。它要求您向服务器提供一个Synapse个人访问令牌。
MCP服务器设置
远程服务器
在您的客户端中使用此URL： 🔌 https://mcp.synapse.org/mcp（可翻译为：“电源插头链接：https://mcp.synapse.org/mcp”，但通常网址不直接翻译，保留原样即可，此处仅为说明其可能代表的含义）
Claude Desktop 操作指南
前往设置 > 连接器 > 添加自定义连接器
克劳德·科德
claude mcp add --transport http synapse -- https://mcp.synapse.org/mcp
本地服务器
要运行本地服务器，请参阅 DEVELOPMENT.md 翻译为中文是：“开发指南.md” 或 “开发文档.md”（具体翻译可能根据上下文有所调整，但基本意思是指一个关于开发的Markdown文件）
示例提示
见 使用示例
做出贡献
欢迎投稿！请参阅我们的 开发指南 有关设置开发环境、运行测试等更多操作的说明。
许可证
麻省理工学院（MIT）
联系
如遇问题，请提交问题报告。如需其他联系方式，请访问https://sagebionetworks.org/contact。
