Provides standards documentation and reference implementations for building platform-compliant agents using the LangChain framework.
Exposes platform standards and architectural guidelines for using Neo4j to implement agent memory systems.
Supplies documentation and configuration standards for integrating OpenTelemetry observability within agent architectures.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Darwin Standards MCP Servervalidate my agent card against platform standards"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Darwin Standards MCP Server
MCP server providing standards documentation and validation tools for the Darwin platform.
Overview
The Standards MCP Server is designed to:
Expose standards as MCP resources - Agents can read platform standards via standard URIs
Provide validation tools - Validate naming conventions, tool definitions, and agent cards
Enable standards search - Find relevant standards documentation quickly
Note: This is an MCP Server, not a true Agent. It provides tools and resources but does not contain an LLM and does not make autonomous decisions.
Quick Start
Option 1: Docker (Recommended for local development)
# Build and run
make build
make run
# Or with docker directly
docker build -t standards-mcp-server .
docker run -p 8080:8080 \
-v /path/to/standards:/app/standards:ro \
-e MCP_TRANSPORT=http \
standards-mcp-serverOption 2: Local Installation
# Create virtual environment and install
make install
# Run locally (stdio mode)
make run-local
# Run locally (HTTP mode)
make run-httpOption 3: Claude Code Integration
# Using Python module directly
claude mcp add --transport stdio \
--env STANDARDS_PATH=/path/to/docs/standards \
standards -- python -m standards_mcp_server.server
# Using container
claude mcp add --transport stdio standards -- \
docker run --rm -i \
-v /path/to/docs/standards:/app/standards:ro \
-e MCP_TRANSPORT=stdio \
fgsansharedacrdeveus.azurecr.io/standards-mcp-server:latestMCP Resources
Standards Documentation
URI | Description |
| Agent design principles |
| A2A protocol standards |
| MCP tool integration |
| Neo4j memory architecture |
| OpenTelemetry setup |
| Security requirements |
| MCP server architecture |
| Tool definition standards |
| Resource exposure standards |
| MCP security patterns |
| Error handling standards |
Templates and Implementations
URI | Description |
| Python MCP server template |
| .NET MCP server template |
| This server's implementation |
| LangChain agent |
MCP Tools
Validation Tools
validate_azure_resource_name- Validate Azure resource names against naming conventionsvalidate_mcp_tool_definition- Validate MCP tool definitions against standardsvalidate_agent_card- Validate A2A agent cards against protocol standards
Search Tools
search_standards- Full-text search across standards documentslist_standards_categories- List all available categoriesget_standards_summary- Get document summaries for a category
Configuration
Variable | Description | Default |
| Server name |
|
| Transport type ( |
|
| HTTP port |
|
| HTTP host |
|
| Log level |
|
| Path to standards docs |
|
| Path to implementations |
|
| Enable OpenTelemetry |
|
| OTLP endpoint |
|
Development
Running Tests
# Run all tests
make test
# With coverage
make test-cov
# Linting
make lint
# Type checking
make typecheckProject Structure
darwin-standards-mcp/
├── .github/
│ ├── workflows/ # CI/CD pipelines
│ └── PULL_REQUEST_TEMPLATE.md
├── .k8s/
│ ├── base/ # Base Kubernetes manifests
│ └── overlays/ # Environment-specific overlays
│ ├── dev/
│ └── prod/
├── src/standards_mcp_server/
│ ├── __init__.py
│ ├── server.py # Main MCP server
│ ├── config.py # Configuration
│ ├── observability.py # OpenTelemetry setup
│ ├── resources/ # MCP resources
│ └── tools/ # MCP tools
├── tests/
├── scripts/ # Deployment scripts
├── docs/ # Documentation
├── Dockerfile
├── Makefile
└── pyproject.tomlDeployment
Deploy to AKS
# Using make
make deploy
# Using script
./scripts/deploy-to-aks.shManual Deployment
# Get AKS credentials
az aks get-credentials --resource-group rg-fgsan-shared-dev-eus --name fgsan-shared-aks-dev-eus
# Apply manifests
kubectl apply -k .k8s/overlays/dev
# Verify
kubectl get pods -n darwin-mcp -l app=standards-mcp-serverSee DEPLOYMENT.md for detailed deployment instructions.
CI/CD
The repository includes GitHub Actions workflows for:
lint-and-test.yml - Runs on PRs: linting, testing, type checking
build-and-push.yml - Runs on push to main: builds and pushes Docker image to ACR
deploy-to-aks.yml - Runs after build: deploys to AKS
release.yml - Runs on version tags: creates GitHub releases
License
MIT License - see LICENSE for details.