Agrus.ai — Enterprise AI Agency

mcp-agrus-ai

一个面向 Agrus.ai 的模型上下文协议服务——这是一家为受监管行业提供前沿 AI 服务的机构。

此服务让 AI Agent（Claude、ChatGPT、Gemini、自定义采购方 Agent）能够以编程方式与 Agrus.ai 互动。使用内部 Claude 助手的 CIO 可以询问 “帮我找一家符合 HIPAA 要求、提供可自托管部署的 AI 咨询公司，并规划一个为期 2 周的临床分诊 PoC”，而该助手可以通过此 MCP 服务完成大部分工作流。

目前提供 5 个只读工具（第一阶段）。写入工具（预约电话、申请方案、询价）将在第二阶段推出——请参阅路线图。

工具

工具	说明
list_services	六大服务支柱及已公布的定价档位（范围界定电话、Discovery Sprint $15-30K、Build 按工时计费 $200-280/hr、Managed SLA $4-15K/mo）。
list_verticals	首年覆盖的七个垂直领域（医疗保健、保险、法律、私募股权、家族办公室、企业情报、职业体育），包含合规要点和推进顺序。
query_compliance_position	Agrus 对特定监管制度（HIPAA、SOC 2、ISO 27001、EU AI Act、NAIC、ABA Model Rules、AML/KYC）的书面立场，以及这些制度如何适用于所描述的 AI 用例。
get_case_study	受 NDA 保护的案例研究——客户名称保密，代号、技术和成果公开。
scope_poc	根据用例描述起草完整的 Discovery Sprint 范围（3 周计划、团队组成、价格区间、待确认问题、推荐服务）。

所有工具都会在 MCP text 内容块中返回结构化 JSON。第一阶段的工具无需身份验证。

要求

• Node.js 20+（使用 ES modules + NodeNext 解析）
• 兼容 MCP 的客户端（Claude Desktop、Continue.dev、Cursor，或任何支持 MCP stdio 协议的客户端）

安装

从源代码安装

git clone https://github.com/phwizard/mcp-agrus-ai.git
cd mcp-agrus-ai
npm install
npm run build

构建后的入口文件为 dist/index.js（可执行文件，带有 #!/usr/bin/env node shebang）。

从 npm 安装

npx -y mcp-agrus-ai

无需全局安装。npx 会获取最新发布的版本，并通过 stdio 运行。

使用此服务的三种方式

1. 托管服务（推荐）

此服务公开托管于 https://mcp.agrus.ai/mcp（Streamable HTTP 传输）。无需安装。将支持远程 URL 传输的 MCP 客户端指向：

{
  "mcpServers": {
    "agrus": {
      "url": "https://mcp.agrus.ai/mcp"
    }
  }
}

2. 通过 npx 使用本地 stdio

适用于 Claude Desktop 和其他偏好 stdio 的客户端：

{
  "mcpServers": {
    "agrus": {
      "command": "npx",
      "args": ["-y", "mcp-agrus-ai"]
    }
  }
}

macOS 上 Claude Desktop 的配置路径：~/Library/Application Support/Claude/claude_desktop_config.json。

3. 从源代码使用本地 stdio

适用于基于本地检出版本进行开发：

{
  "mcpServers": {
    "agrus": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-agrus-ai/dist/index.js"]
    }
  }
}

编辑配置后，重启 MCP 客户端。七个 Agrus 工具将在任何对话中可用。试试：

使用 agrus MCP 查询 Agrus 对 HIPAA 的立场，针对的是一个基于患者 EHR 起草临床记录的 AI Agent。

为一家希望借助 AI 进行理赔分诊并开展偏差测试的保险公司，与 Agrus 规划一个 Discovery Sprint。

列出 Agrus 的垂直领域，并告诉我金融科技监管报告 Copilot 属于哪个领域。

与其他 MCP 客户端搭配使用

任何支持 MCP stdio 或 Streamable HTTP 的客户端都可以使用。远程使用时，标准端点为 https://mcp.agrus.ai/mcp，发现清单位于 https://mcp.agrus.ai/.well-known/mcp.json。

直接测试服务

通过 stdio 发送原始 MCP 协议消息：

printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0.0.1"}}}' \
  '{"jsonrpc":"2.0","method":"notifications/initialized"}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' \
  | node dist/index.js

你应该会看到协议握手，以及一个列出全部 7 个工具（5 个只读 + 2 个写入）的 JSON-RPC 响应。

开发

npm test            # run the full test suite once (~250ms, 86 tests)
npm run test:watch  # watch mode for active development
npm run typecheck   # strict TypeScript check across src/ + api/
npm run build       # compile to dist/
npm run verify      # typecheck + test + build, in that order

测试套件覆盖内容完整性（slug 唯一性、枚举覆盖范围）、7 个工具处理程序各自的测试（正常路径和架构拒绝路径）、HubSpot 客户端（通过模拟 fetch 测试 upsert POST → 409 回退 GET → PATCH 调用链），以及使用 SDK 的 InMemoryTransport 完成的端到端 MCP 协议握手（验证通过 stdio 和 HTTP 运行的同一套代码在进程内也能正常工作）。

GitHub Actions 会在每次推送到 main 以及每个 PR 时运行 npm run verify——详见 .github/workflows/test.yml。

架构

src/
├── index.ts                          ← Entry point. McpServer + stdio transport.
├── content/                          ← Source of truth for Agrus content.
│   ├── services.ts                   ← 6 service pillars + descriptions.
│   ├── verticals.ts                  ← 7 verticals + compliance pins.
│   ├── compliance-regimes.ts         ← 7 regulatory regimes + Agrus position.
│   ├── case-studies.ts               ← NDA-protected codenamed case studies.
│   └── pricing.ts                    ← Published pricing tiers.
└── tools/
    ├── index.ts                      ← Tool registration table.
    ├── list-services.ts
    ├── list-verticals.ts
    ├── query-compliance-position.ts
    ├── get-case-study.ts
    └── scope-poc.ts

每个工具都定义一个 Zod inputSchema（一个 ZodRawShape）和一个返回 MCP 内容的 handler 函数。工具通过 tools/index.ts 中的注册表接入服务端——添加第六个工具只需编写一个新文件，并在注册表中添加一项。

存在的意义

2026 年，越来越多的买家研究由代表人类行事的 AI Agent 完成。使用内部 Claude 助手的 CIO 可以询问：“帮我找三家提供可自托管、符合 HIPAA 的部署方案的 AI 咨询公司，并安排介绍会。” 如果我们能被 MCP 发现，就能参与这场对话；如果不能，对这类买家而言，我们便无从可见。

这也是 Agrus 品牌差异化的核心所在：我们是一家投入资源让 AI Agent 能与之互动的 AI 机构。当潜在客户问“你们是真的 AI 优先，还是只是在用营销术语？”时，我们就会指向 MCP 服务。

路线图

阶段 1（本次发布）

• 5 个只读工具（list_services、list_verticals、query_compliance_position、get_case_study、scope_poc）
• 为本地 MCP 客户端提供 Stdio 传输（Claude Desktop、Continue.dev 等）
• 以 MIT 许可证开源发布

阶段 2（下一阶段）

• HTTP+SSE 传输，托管于 mcp.agrus.ai
• 使用 Vercel 部署（与营销网站的技术栈一致）
• 在 /.well-known/mcp.json 提供众所周知的清单
• 添加带电子邮件 OTP 验证的写入工具：
  • request_quote — 提供大致价格范围，无需承诺
  • request_proposal — 触发正式提案工作流，并在 HubSpot 中创建 agrus_lead_source=agrus_mcp 的潜在客户记录
  • book_consultation — 转交至 Google Calendar、在 HubSpot 中执行 upsert，并发送 Slack 提醒
• 速率限制（Upstash Redis）
• 提交至 Anthropic MCP 目录和 awesome-mcp 列表

阶段 3（之后）

• 按客户范围限定的 API 密钥身份验证
• 为现有客户的 AI Agent 提供 check_engagement_status
• npm 包（@agrus/mcp-server）
• 将 HTTP 传输层开源，作为参考实现

贡献

欢迎提交问题和 PR。内容模块（src/content/*.ts）是最容易参与贡献的地方——可以修正内容、添加新的合规制度，或改进案例研究的代号。较大的改动（新增工具、新增传输方式）应先提交问题进行讨论。

相关项目

• Agrus.ai — 此服务端所代表的机构网站
• Ethora — 我们的开放式聊天与 AI Agent SDK；Agrus 网站基于它运行
• Model Context Protocol — 此服务端使用的开放协议
• @modelcontextprotocol/sdk — 我们使用的 Anthropic 官方 TypeScript SDK

许可证

MIT — 详见 LICENSE。版权所有 (c) 2026 Dappros Ltd.