Zally MCP Server

MCP开发工具

提供方 jbovet · 包名 tsx

开发工具 stdio · 本地进程 无需鉴权 社区 / 第三方
查看接入方式

The OpenAPI MCP Server powers seamless communication using agents and REST APIs by implementing the Model Context Protocol

一句话选型结论

按资料字段整理

Zally MCP Server 属于开发工具类 MCP 服务器,stdio · 本地进程,无需鉴权,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

适用场景

developer-toolsAPI规范检查TypeScript本地部署API质量评分API设计审查RESTAPILLM集成

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
APILINTER_URL={APILINTER_URL} docker-compose -f /path/to/your/project/docker-compose.yml up mcp-server --build {"APILINTER_URL":"http://localhost:8000"}

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

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

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

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Zally MCP Server当前 未标注 stdio · 本地进程 本地部署 有 2026-05-18
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

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

详细介绍

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

APILinter MCP服务器

OpenAPI MCP服务器通过实现模型上下文协议(MCP)来实现LLM和REST API之间的无缝通信。

特性

能力 已实施 备注
结构化日志记录 ✅
度量与监控 ✅
断路器 ✅
重试模式 ✅
健康检查 ✅
API文档 ❌ 规划
速率限制 ❌ 规划
安全控制 ❌
错误处理 ✅
OpenTeletry ❌ 规划

MCP协议合规性

功能 已实现 备注
协议规范 ✅ v2025-03-26
MCP身份验证 ❌ 没有必要
会话管理 ❌ 无国籍
工具支持 ✅ validate_api_specification list_rules calculate_api_quality_score get_rule_categories get_api_docs get_api_linter_link
资源支持 ❌
提示支持 ✅ api_design_review
可流式HTTP传输 ✅
SSE 运输 ❌ 没有计划
STDIO传输 ❌ 没有计划
SDK客户端 ✅

安装

  1. 克隆存储库:```bash
    git clone git@github.com:jbovet/zally-mcp-server.git
    cd zally-mcp-server

项目结构:

- `src/`:包含TypeScript源代码。
- `circuitbreaker/`:断开电路并重试执行。
- `config/`:配置文件。
- `controllers/`:Express控制器,包括StreamableHttp控制器。
- `models/`:数据模型的TypeScript接口。
- `repositories/`:API Linter的数据访问层。
- `services/`:API Linter和MCP集成的业务逻辑。
- `utils/`:实用程序类,包括HTTP客户端和错误处理。
- `target/`:编译的JavaScript文件。
- `package.json`:项目元数据和依赖关系。
- `tsconfig.json`:TypeScript配置文件。
- `curl-mcp-client.sh`:通过curl测试MCP服务器端点的Bash脚本。
- `README.md`:项目文件。

1. 安装依赖项:```bash
npm install
  1. 构建项目:```bash
    npm run build

## 配置

环境变量:

- `PORT`:服务器端口(默认值:3000)
- `APILINTER_URL`:API Linter服务URL(默认值: )
- `RETRY_COUNT`:失败请求的重试次数(默认值:3)
- `CIRCUIT_BREAKER_THRESHOLD`:触发断路器的故障阈值(默认值:5)

## 运行服务器

> **_注:_** 之前,您需要运行Zally Server,您可以在此处查看文档

使用以下命令启动服务器:```bash
npm run dev

MCP服务器将在端点上以流式HTTP模式运行:

测试服务器

使用以下命令运行测试:```bash
npm run test


## 运行示例客户端

要运行MCP服务器的示例交互式客户端,请使用以下命令:```bash
npx tsx example/simpleStreamableHttp.ts

这将启动交互式客户端,允许您测试MCP服务器的各种命令和功能。bash > list-rules > list-rules true > validate-api ./my-api-spec.yaml > validate-api-rules ./my-api-spec.json id

工具

MCP服务器为API Linting提供以下工具:

  • validate_api_specification:根据API Linter规则验证API规范(OpenAPI/Swagger)

  • 参数: spec (API规范内容), ruleIds (要使用的规则ID的可选列表)

  • 返回:包含违规和格式的验证结果
  • 重试逻辑:在瞬态故障的情况下重试验证请求
  • 断路器:如果API Linter服务没有响应,则停止验证请求

  • list_rules:列出所有可用的API Linter规则

  • 参数: isActive (可选布尔值,按活动状态过滤)

  • 返回:可用linting规则及其详细信息的列表
  • 重试逻辑:在暂时失败的情况下检索规则列表请求
  • 断路器:如果API Linter服务超过故障阈值,则阻止进一步的请求

  • calculate_api_quality_score:计算API规范的质量分数

  • 参数: spec (API规范内容)

  • 退货:质量评分及明细

  • get_rule_categories:检索API Linter规则的类别

  • 参数:无

  • 返回:规则类别列表

鼓励

MCP服务器提供以下预配置的提示:

  • api_design_review:分析API规范并提供全面的设计反馈
  • 参数:
  • specification (API规范内容为JSON或YAML格式)
  • focusAreas (可选的逗号分隔的关注领域列表,例如“安全性、命名、一致性”)
  • 返回:结构化API设计反馈,包括:
  • API用途和设计执行摘要
  • 优势识别
  • 需要改进的领域(命名、一致性、错误处理、安全性等)
  • API增强的具体建议

安全说明

  • 实施源验证以防止DNS重新绑定攻击
  • 在无状态模式下使用流式HTTP传输以确保安全
  • 在开发中仅处理来自受信任来源(localhost)的请求
  • 所有API输入在处理前都经过验证
  • 重试逻辑和断路器:通过优雅地处理服务故障来增强弹性和安全性

贡献

欢迎投稿!请随时提交拉取请求。

  1. 分叉存储库
  2. 创建功能分支(git checkout -b feature/amazing-feature)
  3. 安装依赖项(npm install)
  4. 进行更改
  5. 运行测试以确保通过(npm test)
  6. 提交您的更改(git commit -m 'Add some amazing feature')
  7. 推到分支(git push origin feature/amazing-feature)
  8. 打开拉取请求

许可证

该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。

常见问题

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

在客户端按下面的安装命令接入:APILINTER_URL={APILINTER_URL} docker-compose -f /path/to/your/project/docker-compose.yml up mcp-server --build {"APILINTER_URL":"http://localhost:8000"}。对应的包名是 tsx。装完在客户端配置里引用同一个包或端点。

Zally MCP Server 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Zally MCP Server 收费吗?

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

Zally MCP Server 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Zally MCP Server 能提供哪些能力?

资料显示能力标签包括 API集成、TypeScript、开发工具。具体工具清单以官方文档为准。

Zally MCP Server 需要什么运行环境?

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

Zally MCP Server 是本地还是远程?

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

热门专题

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

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