syrin (Ankan Labs)

叙利亚

](https://www.npmjs.com/package/@syrin/cli)  ](https://nodejs.org/)

MCP服务器的linter+测试运行器。

______________________________________________________________________

问题

MCP（模型上下文协议） AI代理如何调用外部工具——读取文件、查询数据库、点击API。如果你正在构建或使用MCP服务器，你的AI代理取决于这些工具定义是否正确。

他们通常不是。

• 工具描述过于模糊，LLM无法选择正确的工具
• 两个工具看起来如此相似，以至于模型随机选择了一个
• 参数模式缺失或错误——LLM产生幻觉值
• 一个工具返回12MB的JSON并弹出上下文窗口
• 另一个工具在不应该写入磁盘时会自动写入磁盘
• 你的原木看起来很好。代理人坏了。

Syrin在生产前捕获了所有这些。

$ syrin analyse --transport http --url http://localhost:8000/mcp

 E110  Tool Ambiguity           get_user ↔ fetch_user
 E101  Missing Tool Description process_data has no description
 E102  Underspecified Input     user_id: no format, no example, no enum
 E105  Free Text Propagation    get_status → update_user (unconstrained string)
 W104  Generic Description      "Get data" — too vague for tool selection

 5 issues found (4 errors, 1 warning)

______________________________________________________________________

在行动中看到它

______________________________________________________________________

马上试试

一个命令。没有安装，没有配置，没有API密钥：

npx @syrin/cli analyse --transport http --url https://docs.syrin.dev/mcp

您自己的MCP服务器正在运行吗？指向Syrin：

npx @syrin/cli analyse --transport http --url http://localhost:8000/mcp

如果您的服务器使用stdio而不是HTTP：

npx @syrin/cli analyse --transport stdio --script "python server.py"

想对本地示例服务器尝试更多命令吗？

git clone https://github.com/Syrin-Labs/cli.git
cd cli/examples/demo-mcp-py
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python server.py --mode http --port 8000 &

npx @syrin/cli list tools --transport http --url http://localhost:8000/mcp
npx @syrin/cli analyse --transport http --url http://localhost:8000/mcp

要求： Node.js>=20.12，npm>=9

______________________________________________________________________

Syrin捕获了什么

查看完整列表： 错误参考 · 警告参考

______________________________________________________________________

命令

零配置命令： list, analyse，以及 test --connection 与just合作 --url 或 --script。不需要配置文件。

需要配置： dev 模式需要LLM API密钥。跑 syrin init --global 设置一次。

______________________________________________________________________

所有Demos

syrin analyse Catch contract issues syrin dev Interactive development syrin test Sandboxed tool testing

syrin init Project setup syrin list Inspect tools syrin test --connection Connection test

______________________________________________________________________

安装

# Run without installing
npx @syrin/cli analyse --transport http --url http://localhost:8000/mcp

# Or install globally
npm install -g @syrin/cli
syrin --version

为项目设置

syrin init                 # Creates syrin.yaml + tools/ directory
syrin doctor               # Validates config and connections
syrin analyse              # Analyse your MCP server
syrin test                 # Run contract tests
syrin dev --exec           # Interactive LLM-MCP session

工具合同

为您的工具定义行为保证 tools/.yaml:

version: 1
tool: fetch_user

contract:
  input_schema: FetchUserRequest
  output_schema: User

guarantees:
  side_effects: none
  max_output_size: 10kb

tests:
  - name: 'valid user'
    input:
      user_id: '123'
    expect:
      output_schema: User

  - name: 'invalid input'
    input:
      user_id: 123
    expect:
      error:
        type: input_validation

运行测试： syrin test 或 syrin test --tool fetch_user

文档： 编写测试用例 · 测试您的MCP工具

______________________________________________________________________

CI集成

# .github/workflows/syrin.yml
name: MCP Validation
on: [push, pull_request]
jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
      - run: npm install -g @syrin/cli
      - run: syrin analyse --ci
      - run: syrin test --ci --strict

查看完整的CI文档： 将Syrin添加到CI

______________________________________________________________________

文档

完整文档请访问 docs.syrin.dev

______________________________________________________________________

社区

• Discord 的中文翻译是“不和谐”或“纷争”。 --提问，分享反馈
• --特色创意，展示与讲述
• 问题 --Bug报告、功能请求

______________________________________________________________________

贡献

欢迎捐款。看 贡献指南 和 行为准则.

关于安全问题： 安全策略.

许可证

ISC许可证。看 许可证.

由……制造 Syrin实验室.