Synapse MCP Infra

MCP运维云端

提供方 Sage-Bionetworks-IT

运维云端 stdio · 本地进程 OAuth 授权 社区 / 第三方 Claude DesktopClaudeVS Code
查看接入方式

使用AWS CDK构建ECS基础设施的GitHub模板项目,提供开发容器支持、自动化测试和部署流程。

一句话选型结论

按资料字段整理

Synapse MCP Infra 属于运维云端类 MCP 服务器,stdio · 本地进程,OAuth 授权,可直接接入 Claude Desktop、Claude、VS Code,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

AWSCDKPython本地部署ECS部署基础设施即代码云原生DevOps

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
python -m pytest tests/ -s -v

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、VS Code,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Synapse MCP Infra当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Sage-Bionetworks-IT上游标注的维护方 Sage-Bionetworks-IT
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

11.2 KB
来自项目仓库与上游目录的原文,未做删改

AWS CDK应用程序

使用AWS CDK创建ECS基础设施项目的Github模板

先决条件

AWS CDK项目在合成或部署之前需要一些引导。
请查看 bootstapping文档
在开发之前。

> [!注意]
> Sage IT在我们的AWS组织中创建每个AWS帐户时都会部署此CDK引导程序。

开发容器

此存储库提供 dev容器 包括所有工具
需要开发此AWS CDK应用程序。

在开发容器中打开项目

使用VS代码:

  1. 克隆此仓库
  2. 文件>打开文件夹。..
  3. 提示应邀请您在开发容器中打开项目。如果没有,打开VS Code
    命令面板并选择“开发容器:打开容器中的文件夹…”

使用GitHub代码空间:

  1. 在该存储库的主页上,单击按钮“代码”>代码空间>单击
    按钮“创建代码空间”

就是这样!现在,您已进入开发容器,可以访问所有开发工具。

发展

在dev容器内开发时提供所有开发工具
(见上文)。这些工具包括Python、AWS CLI、AWS CDK CLI等。这些工具
还包括一个Python虚拟环境,其中需要所有Python包
已安装。

如果您决定在开发容器之外进行开发
可以通过运行以下命令安装工具:```console
./tools/setup.sh


开发需要激活Python虚拟环境:```
$ source .venv/bin/activate

此时,您现在可以合成此代码的CloudFormation模板。```
$ cdk synth


要添加其他依赖项,例如其他CDK库,只需添加
他们给你 `setup.py` 文件并重新运行 `pip install -r requirements.txt`
命令。

## 有用的命令

- `cdk ls` 列出应用程序中的所有堆栈
- `cdk synth` 发出合成的CloudFormation模板
- `cdk deploy` 将此堆栈部署到默认的AWS帐户/区域
- `cdk diff` 将部署的堆栈与当前状态进行比较
- `cdk docs` 打开CDK文档

# 测试

## 静态分析

作为预部署步骤,我们对CDK-json、yaml和
python文件 预承诺.

请安装预提交,安装后文件验证将
每次提交时自动运行。或者,您可以手动
通过运行以下命令执行验证 `pre-commit run --all-files`.

通过运行\[CDK synth\]验证CDK到Cloudformation的转换:```console
cdk synth --context env=dev

云信息输出保存到 cdk.out 文件夹

单元测试

测试位于Tests文件夹中。执行以下操作以运行测试:```
python -m pytest tests/ -s -v


## 环境

跑步时 `cdk` 命令,您必须指定哪个环境
配置使用。这是通过将上下文变量传递给
CDK,加载特定于环境的参数。

在中创建配置文件 config文件夹 对于每种环境
(例如。, `dev.yaml`, `prod.yaml`).支持yaml和json文件。
支持的环境是dev、stage和prod。

使用 `prod` 环境配置:```console
cdk synth --context env=prod

还有一个始终加载的可选基本配置文件
并与传入的环境配置之一合并。

特定于环境的配置文件中的值将
如果存在冲突,请覆盖基本配置文件中的那些。
例如,如果两个文件都定义 TAGS,价值来自 dev.yaml
将优先考虑。

> [!注意]
> 确保 VPC_CIDR 在您的AWS组织中是独一无二的。

必需的AWS机密

在部署synapse mcp服务之前,您必须在AWS secrets Manager中创建以下机密:

  1. synapse mcp/oauth客户端密钥
    - 包含Synapse OAuth客户端密钥
    - 创建方式: aws secretsmanager create-secret --name synapse-mcp-{env}/oauth-client-secretval --secret-string "your-client-secret"

这些秘密会自动作为环境变量注入(SYNAPSE_OAUTH_CLIENT_SECRET)进入ECS容器。

> [!重要]
> 确保这些机密存在于部署堆栈的同一AWS区域中。

Valkey基础设施

该基础设施包括用于Valkey的AWS ElastiCache无服务器(兼容Redis),用于:

  • 客户端注册表:OAuth客户端注册(MCP客户端,如Claude Desktop、VS Code)
  • 会话存储:用户身份验证令牌和会话

Valkey配置

Valkey无服务器设置在配置文件中按环境配置:

  • 引擎版本:Valkey 8.2(最新版本)
  • 容量:通过可配置的最大ECPU和存储自动扩展
  • dev/state/prod:当前设置为最低1000 ECPU/秒,1 GB存储

主要特点:

  • 无服务器:根据需求自动扩展容量
  • 加密:启用了传输中的TLS和静态加密
  • 每日快照:实现数据持久性的自动化每日快照
  • 安全:仅限专用子网,只能从ECS任务访问
  • 连接:通过自动配置 REDIS_URL 环境变量

Valkey连接URL存储在AWS Systems Manager参数存储中 /synapse-mcp/{environment}-redis/redis-url 并自动注入ECS容器。
请参阅我们的 指导 在选择唯一的CIDR块时。

证书

应在AWS证书管理器中手动创建用于设置HTTPS连接的证书。
由于AWS要求手动验证域所有权,因此这不是自动化的。
创建后,获取证书的ARN,并在environment_variables中设置该ARN。

秘密

可以在中手动创建秘密
AWS机密管理器.
命名秘密时,请确保秘密不会以匹配的模式结尾
-??????,这将导致AWS CDK查找机密的方式出现问题。

要将机密传递给容器,请设置机密管理器 container_secrets
当创建a ServiceProp 对象。您将创建一个列表 ServiceSecret 物体:```python
from src.service_props import ServiceProps, ServiceSecret

app_service_props = ServiceProps(
ecs_task_cpu=256,
ecs_task_memory=512,
container_name="app",
container_port=443,
container_location="ghcr.io/sage-bionetworks/app:v1.0",
container_secrets=[
ServiceSecret(
secret_name="app/dev/DATABASE",
environment_key="NAME_OF_ENVIRONMENT_VARIABLE_SET_FOR_CONTAINER",
),
ServiceSecret(
secret_name="app/dev/PASSWORD",
environment_key="SINGLE_VALUE_SECRET",
)
]
)


例如,KVs `app/dev/DATABASE` 可以是:```json
{
"DATABASE_USER": "maria",
"DATABASE_PASSWORD": "password"
}

以及价值 app/dev/PASSWORD 可以是: password

在应用程序(Python)代码中,可以使用以下代码将机密加载到字典中:```python
import json
import os

all_secrets_dict = json.loads(os.environ["NAME_OF_ENVIRONMENT_VARIABLE_SET_FOR_CONTAINER"])


对于单个值,您可以加载该值,如下所示:```python
import os

my_secret = os.environ.get("SINGLE_VALUE_SECRET", None)

> [!注意]
> 检索机密需要访问AWS机密管理器

域名系统

DNS CNAME必须在初始设置后在组织结构中创建
部署应用程序,使应用程序在所需的时间可用
URL。CDK应用程序导出应用程序负载平衡器的DNS名称
在组织结构中被消耗。 PR设置CNAME的示例.

登录AWS云信息控制台并导航到已部署的堆栈 app-load-balancer
然后单击 Outputs tab。在键为的行上 LoadBalancerDNS 寻找
价值在 Export Name 例如。, app-dev-load-balancer-dns.

现在使用名称 TargetHostName 定义,例如:```
TargetHostName: !CopyValue [!Sub 'app-dev-load-balancer-dns', !Ref DnTDevAccount]


(您也可以替换 `DnTDevAccount` 使用部署应用程序的帐户名称。)

> \[!注意\]
> DNS名称的设置应在本次基础设施设置的最后完成

## 调试

通常,CDK部署将在CDK部署期间创建云形成事件。
这些事件可以在AWS控制台的cloudformation服务页面下查看。
查看这些事件将有助于解决部署过程中的错误。以下是案例
由于错误误导或错误不足,可能难以调试
来自AWS的消息

### 失踪的秘密

每个新环境(dev/ststage/prod/等)都可能需要添加机密。如果
没有为环境创建secret,您可能会遇到以下错误
堆栈跟踪。.```
Resource handler returned message: "Error occurred during operation 'ECS Deployment Circuit Breaker was triggered'." (RequestToken: d180e115-ba94-d8a2-acf9-abe17a3aaed9, HandlerErrorCode: GeneralServiceException)
new BaseService (/private/var/folders/qr/ztb40vmn2pncyh8jpsgfnrt40000gp/T/jsii-kernel-4PEWmj/node_modules/aws-cdk-lib/aws-ecs/lib/base/base-service.js:1:3583)
\_ new FargateService (/private/var/folders/qr/ztb40vmn2pncyh8jpsgfnrt40000gp/T/jsii-kernel-4PEWmj/node_modules/aws-cdk-lib/aws-ecs/lib/fargate/fargate-service.js:1:967)
\_ new ApplicationLoadBalancedFargateService (/private/var/folders/qr/ztb40vmn2pncyh8jpsgfnrt40000gp/T/jsii-kernel-4PEWmj/node_modules/aws-cdk-lib/aws-ecs-patterns/lib/fargate/application-load-balanced-fargate-service.js:1:2300)
\_ Kernel._create (/private/var/folders/qr/ztb40vmn2pncyh8jpsgfnrt40000gp/T/tmpqkmckdm2/lib/program.js:9964:29)
\_ Kernel.create (/private/var/folders/qr/ztb40vmn2pncyh8jpsgfnrt40000gp/T/tmpqkmckdm2/lib/program.js:9693:29)
\_ KernelHost.processRequest (/private/var/folders/qr/ztb40vmn2pncyh8jpsgfnrt40000gp/T/tmpqkmckdm2/lib/program.js:11544:36)
\_ KernelHost.run (/private/var/folders/qr/ztb40vmn2pncyh8jpsgfnrt40000gp/T/tmpqkmckdm2/lib/program.js:11504:22)
\_ Immediate._onImmediate (/private/var/folders/qr/ztb40vmn2pncyh8jpsgfnrt40000gp/T/tmpqkmckdm2/lib/program.js:11505:46)
\_ processImmediate (node:internal/timers:464:21)

部署

独自创立

在部署应用程序之前,需要手动引导一些项目。

  • 将机密添加到AWS机密管理器
  • 创建一个 申请ACM证书 使用AWS证书管理器
  • 更新中的environment_variables app.py 每个环境都有特定的变量。
  • 更新对docker镜像的引用 app.py
    (即。 ghcr.io/sage-bionetworks/app-xxx:)
  • (可选)更新 ServiceProps 对象在 app.py 具有特定参数
    每个集装箱。

使用AWS CLI登录

> [!注意]
> 本节和以下部分假设您在AWS帐户中工作
> org-sagebase-itsandbox 随着角色 Developer 并且您正在部署
> 到 us-east-1 区域。如果这个假设是正确的,你应该能够
> 只需复制粘贴以下命令,否则调整
> 配置应该很简单。

如果配置文件还不存在,请创建它。```console
mkdir ~/.aws && touch ~/.aws/config


作为Sage IT Sandbox AWS帐户的开发人员,请将以下配置文件添加到配置文件中。```ini
[profile itsandbox-dev]
sso_start_url = https://d-906769aa66.awsapps.com/start
sso_region = us-east-1
sso_account_id = XXXXXXXXX
sso_role_name = Developer

使用AWS CLI登录:```console
aws --profile itsandbox-dev sso login


## 部署

部署需要设置 AWS配置文件
然后执行以下命令:```console
AWS_PROFILE=itsandbox-dev AWS_DEFAULT_REGION=us-east-1 cdk deploy --context env=dev --all

强制新部署```console

AWS_PROFILE=itsandbox-dev AWS_DEFAULT_REGION=us-east-1 aws ecs update-service \
--cluster \
--service \
--force-new-deployment


# 从ECS上运行的容器执行命令

一旦容器成功部署,就可以使用
ECS执行命令

让交互式shell运行到容器中的示例:```console
AWS_PROFILE=itsandbox-dev AWS_DEFAULT_REGION=us-east-1 aws ecs execute-command \
--cluster AppEcs-ClusterEB0386A7-BygXkQgSvdjY \
--task a2916461f65747f390fd3e29f1b387d8 \
--container app-mariadb \
--command "/bin/sh" --interactive

CI工作流

此仓库已设置为使用Github Actions CI持续部署应用程序。

持续集成的工作流程:

  • 从git dev分支创建PR
  • PR经过审查和批准
  • PR已合并
  • CI将更改部署到AWS开发帐户中的开发环境(dev.app.io)。
  • 更改被提升(或合并)到git stage分支。
  • CI将更改部署到AWS prod帐户中的暂存环境(stage.app.io)。
  • 更改被提升(或合并)到git prod分支。
  • CI将更改部署到AWS prod帐户中的prod环境(prod.app.io)。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Synapse MCP Infra 怎么安装?

在客户端按下面的安装命令接入:python -m pytest tests/ -s -v。装完在客户端配置里引用同一个包或端点。

Synapse MCP Infra 怎么在 Claude Desktop、Claude、VS Code 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Synapse MCP Infra 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Synapse MCP Infra 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Synapse MCP Infra 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Synapse MCP Infra 能提供哪些能力?

资料显示能力标签包括 基础设施即代码、Python、Claude、云原生。具体工具清单以官方文档为准。

Synapse MCP Infra 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Synapse MCP Infra 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。