home / mcp / standards mcp server

Standards MCP Server

Exposes Darwin platform standards as MCP resources and offers validation and search tools.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "fernandogjrtcv-darwin-standards-mcp": {
      "command": "claude",
      "args": [
        "mcp",
        "add",
        "--transport",
        "stdio",
        "--env",
        "STANDARDS_PATH=/path/to/docs/standards",
        "standards",
        "--",
        "python",
        "-m",
        "standards_mcp_server.server"
      ],
      "env": {
        "MCP_HOST": "0.0.0.0",
        "MCP_PORT": "8080",
        "OTEL_ENABLED": "true",
        "MCP_TRANSPORT": "stdio",
        "STANDARDS_PATH": "/path/to/docs/standards",
        "OTEL_EXPORTER_OTLP_ENDPOINT": "<OTEL_EXPORTER_OTLP_ENDPOINT>"
      }
    }
  }
}

You run the Darwin Standards MCP Server to expose platform standards as MCP resources, validate naming and tool definitions, and enable fast searching of standards. It acts as a standards-focused MCP server that provides tooling and resources for agents, without containing an autonomous decision engine.

How to use

You access standards documentation and validation tools through MCP clients that interact with MCP resources. The server exposes standard documents and validation endpoints, and it includes search capabilities to quickly locate relevant standards. Use the standard MCP transport you prefer (stdio for local development or http for remote interactions) and point your client to the server’s exposed resources to read, validate, or search standards.

How to install

Prerequisites you need before installation are a suitable runtime and a tooling environment for running the MCP server. Install and run steps are provided in practical workflows you can follow depending on your preferred setup.

# Option A: Docker (recommended for local development)
# Build and run inside Docker
make build
make run

# Or build and run directly with Docker
docker build -t standards-mcp-server .
docker run -p 8080:8080 \
  -v /path/to/standards:/app/standards:ro \
  -e MCP_TRANSPORT=http \
  standards-mcp-server

Additional configuration and notes

The server supports multiple configuration options and environment variables to tailor its behavior. You can enable HTTP or stdio transport, set the listening host and port, adjust log verbosity, and provide paths to standards documents and reference implementations. The following environment variables are commonly used to configure the server during deployment:

# Common configuration
MCP_SERVER_NAME=standards-mcp-server
MCP_TRANSPORT=stdio
MCP_PORT=8080
MCP_HOST=0.0.0.0
MCP_LOG_LEVEL=INFO
STANDARDS_PATH=docs/standards
REFERENCE_IMPLEMENTATIONS_PATH=reference-implementations
OTEL_ENABLED=true
OTEL_EXPORTER_OTLP_ENDPOINT=null

Development and structure notes

If you plan to extend or customize the server, you can explore the project structure to locate core components such as the main server entry, configuration handling, observability setup, MCP resources, and tool interfaces.

Troubleshooting tips

If you encounter connection issues, verify that the selected transport is reachable (stdio localhost or HTTP endpoint), and check that the server process is running and listening on the expected port. Review log output for any configuration validation errors or missing standard resources.

Available tools

validate_azure_resource_name

Validate Azure resource names against naming conventions

validate_mcp_tool_definition

Validate MCP tool definitions against standards

validate_agent_card

Validate A2A agent cards against protocol standards

search_standards

Full-text search across standards documents

list_standards_categories

List all available standards categories

get_standards_summary

Get document summaries for a category