Schema.org MCP Server

MCP (Model Context Protocol) server providing access to schema.org vocabulary and performance testing tools.

Documentation Index

docs/
├── [API.md](docs/API.md)                                13 tools with request/response formats
├── [DEVELOPMENT.md](docs/DEVELOPMENT.md)                Quick start & adding features
├── [PERFORMANCE-MEASUREMENT.md](docs/PERFORMANCE-MEASUREMENT.md)  Testing & measurement
│
├── api-examples/
│   └── [README.md](docs/api-examples/)                  Integration patterns
│
├── development-examples/
│   └── [README.md](docs/development-examples/)          Setup & Claude Desktop config
│
└── performance-suite-examples/
    └── [README.md](docs/performance-suite-examples/)    Test commands & examples

Quick Start

npm install && npm run build && npm start

Setup with Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Features in Detail

Schema Tools (5 endpoints) — Query types, search vocabulary, explore hierarchies, list properties, generate JSON-LD examples

• See API Reference for detailed tool documentation and examples

Metadata Tools (3 endpoints) — Get server metadata as schema.org types (SoftwareApplication, WebAPI, etc.)

Performance Tools (5 endpoints) — Run performance tests (Core Web Vitals, load, stress, soak, scalability), compare results, analyze schema.org impact

• See Performance Examples for test commands

Development

npm run dev      # Watch mode
npm test         # Run tests
npm run build    # Build for production

Architecture

• src/index.ts - MCP server & tool handlers
• src/schema-org-client.ts - Schema.org vocabulary access (fetched & cached in memory)
• src/metadata-generator.ts - Server metadata generation
• src/performance-client.ts - Performance test integration
• performance-suite/ - Comprehensive performance testing with metrics

License

MIT - See LICENSE for details.

Repo: https://github.com/aledlie/schema-org-mcp