Va Lighthouse MCP

VA Lighthouse MCP 服务器

用于渐进式发现和验证VA Lighthouse API的模型上下文协议服务器。该服务器基于Cloudflare Workers构建，使用TypeScript和Zod进行验证。

特点/功能

13 MCP 工具 对于VA API探索：

• 发现 (2): 列出API，获取元数据
• 探索 (5): 概述API，浏览端点，搜索操作，查看模式
• 验证 (4): 验证有效载荷，生成示例，获取验证规则
• 公用设施/公共服务 (2): 检查健康状况，比较版本

生产就绪

• 314项测试（226项单元测试，88项集成测试），代码覆盖率94%
• 具有1小时TTL的LRU缓存，以实现最佳性能
• OpenAPI 3.0 解析和引用解析
• 基于Zod的验证并提供修复建议
• Cloudflare Workers 部署

快速入门

# Install dependencies
npm install

# Start development server
npm run dev

# Run all tests
npm run test:all

服务器运行于 http://localhost:8788/sse

健康检查

curl http://localhost:8788/health

MCP 检查器

测试工具交互式地：

npx @modelcontextprotocol/inspector@latest
# Open http://localhost:5173
# Connect to http://localhost:8788/sse

Claude 桌面集成

添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "va-lighthouse": {
      "command": "npx",
      "args": ["mcp-remote", "http://localhost:8788/sse"]
    }
  }
}

对于生产，请使用： https://va-lighthouse-mcp..workers.dev/sse

文档

• 工具参考 - 所有13个MCP工具的完整文档
• 开发指南 - 设置、测试、代码覆盖率、调试
• 部署指南 - Cloudflare Workers 的部署、配置和监控

测试

• 集成测试 - 集成测试模式和测试框架的使用
• 测试支架/测试框架 - 可重复使用的测试基础设施

建筑

┌─────────────────────────────────────────┐
│  13 MCP Tools (4 categories)            │
├─────────────────────────────────────────┤
│  • Cache (LRU, 1hr TTL)                 │
│  • API Client (VA Lighthouse)           │
│  • OpenAPI Parser (@scalar)             │
│  • Validator (Zod)                      │
├─────────────────────────────────────────┤
│  Cloudflare Workers Runtime             │
└─────────────────────────────────────────┘

项目结构

src/
├── index.ts              # MCP server entry point
├── services/             # Cache, API client, parser, validator
├── tools/                # 13 MCP tools (4 files)
└── utils/                # Error formatting, example generation
test/
├── unit/                 # 226 tests (Workers pool, 94% coverage)
└── integration/          # 88 tests (Node.js + HTTP)
docs/
├── TOOLS.md              # Complete MCP tools reference
├── DEVELOPMENT.md        # Development and testing guide
└── DEPLOYMENT.md         # Cloudflare deployment guide

测试

运行所有测试 （314项测试）

npm run test:all

单元测试 （226个测试，覆盖率94%）

npm run test:unit              # Run unit tests
npm run test:coverage          # Generate coverage report
npm run test:coverage:open     # View coverage HTML report

集成测试 （88项测试）

npm run dev                    # Terminal 1: Start server
npm run test:integration       # Terminal 2: Run integration tests

代码覆盖率

• 整体来说： 94%
• openapi-parser: 99%
• API客户端：96%
• json-schema-to-zod: 93%
• 验证器：85%

见 开发指南 以获取详细的测试信息。

部署

部署到 Cloudflare Workers：

npm run deploy

您的服务器将在以下地址可用：

https://va-lighthouse-mcp..workers.dev/sse

见 部署指南 for: （在中文中，"for" 通常不直接翻译，因为它是一个介词，根据上下文有不同的含义，如“为了”、“对于”等。如果要保留其英文形式并说明其用途，可以翻译为“对于（的）”或“为了（的）”，具体取决于上下文。）

• 账户设置与配置
• 自定义域名
• 环境变量和密钥
• 监控与可观测性
• 成本估算

栈（或称为堆栈）

• 运行时Cloudflare Workers（云防护网络工作者）
• 语言TypeScript 5.9
• MCP（Multi-Channel-Package）@modelcontextprotocol/sdk 1.19
• 验证Zod 3.25
• 解析器@scalar/openapi-parser 0.22
• 测试Vitest 3.2（314个测试，覆盖率94%）

资源

• VA Lighthouse API门户
• 模型上下文协议
• Cloudflare Workers（可译为“Cloudflare 工作人员”或根据上下文简化为“Cloudflare 函数”）

许可证

麻省理工学院（MIT）