va-lighthouse-mcp

agilesix/va-lighthouse-mcp

3.2

If you are the rightful owner of va-lighthouse-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The VA Lighthouse MCP Server is a Model Context Protocol server designed for the progressive discovery and validation of VA Lighthouse APIs, utilizing Cloudflare Workers, TypeScript, and Zod validation.

Tools
13
Resources
0
Prompts
0

VA Lighthouse MCP Server

Model Context Protocol server for progressive discovery and validation of VA Lighthouse APIs. Built on Cloudflare Workers with TypeScript and Zod validation.

Features

13 MCP Tools for VA API exploration:

  • Discovery (2): List APIs, get metadata
  • Exploration (5): Summarize APIs, browse endpoints, search operations, view schemas
  • Validation (4): Validate payloads, generate examples, get validation rules
  • Utilities (2): Check health, compare versions

Production-Ready

  • 314 tests (226 unit, 88 integration) with 94% code coverage
  • LRU cache with 1hr TTL for optimal performance
  • OpenAPI 3.0 parsing and dereferencing
  • Zod-based validation with fix suggestions
  • Cloudflare Workers deployment

Quick Start

# Install dependencies
npm install

# Start development server
npm run dev

# Run all tests
npm run test:all

Server runs at http://localhost:8788/sse

Health Check

curl http://localhost:8788/health

MCP Inspector

Test tools interactively:

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

Claude Desktop Integration

Add to claude_desktop_config.json:

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

For production, use: https://va-lighthouse-mcp.<your-account>.workers.dev/sse

Documentation

  • - Complete documentation for all 13 MCP tools
  • - Setup, testing, code coverage, debugging
  • - Cloudflare Workers deployment, configuration, monitoring

Testing

  • - Integration test patterns and harness usage
  • - Reusable test infrastructure

Architecture

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

Project Structure

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

Testing

Run All Tests (314 tests)

npm run test:all

Unit Tests (226 tests, 94% coverage)

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

Integration Tests (88 tests)

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

Code Coverage

  • Overall: 94%
  • openapi-parser: 99%
  • api-client: 96%
  • json-schema-to-zod: 93%
  • validator: 85%

See for detailed testing information.

Deployment

Deploy to Cloudflare Workers:

npm run deploy

Your server will be available at:

https://va-lighthouse-mcp.<your-account>.workers.dev/sse

See for:

  • Account setup and configuration
  • Custom domains
  • Environment variables and secrets
  • Monitoring and observability
  • Cost estimation

Stack

  • Runtime: Cloudflare Workers
  • Language: TypeScript 5.9
  • MCP: @modelcontextprotocol/sdk 1.19
  • Validation: Zod 3.25
  • Parser: @scalar/openapi-parser 0.22
  • Testing: Vitest 3.2 (314 tests, 94% coverage)

Resources

License

MIT