Governance Server

MCP server for querying the DodaOne governance framework.

Overview

This MCP server wraps the Governance Query Service, enabling any MCP-compatible client (Claude Code, Claude Desktop, etc.) to query governance documents and evaluate proposed actions against the governance framework.

Installation

From npm (once published)

Add to your MCP client configuration:

{
  "mcpServers": {
    "dodaone-governance": {
      "command": "npx",
      "args": ["-y", "@dodaone/governance-mcp-server"],
      "env": {
        "GQS_API_KEY": "your-api-key-here"
      }
    }
  }
}

Local Development

git clone <repo-url>
cd governance-mcp-server
pnpm install
pnpm build

Then configure your MCP client:

{
  "mcpServers": {
    "dodaone-governance": {
      "command": "node",
      "args": ["/path/to/governance-mcp-server/dist/index.js"],
      "env": {
        "GQS_API_KEY": "your-api-key-here"
      }
    }
  }
}

Configuration

Environment Variables

Variable	Required	Description
GQS_API_KEY	Yes	API key for the Governance Query Service

Tool: query_governance

Query the DodaOne governance framework.

Parameters

Parameter	Type	Required	Description
query	string	Yes	The main query text
query_type	string	Yes	"informational" or "operational"
subqueries	array	No	For comparing options (operational queries)
context	object	No	Additional context (division, action_description)

Query Types

Informational: Retrieve factual information from governance documents.

{
  "query": "What are the 5 core principles?",
  "query_type": "informational"
}

Operational: Evaluate proposed actions against the governance framework.

{
  "query": "Should I get my haircut at a salon or do it myself?",
  "query_type": "operational",
  "subqueries": [
    { "text": "Getting haircut at a professional salon", "option_key": "salon" },
    { "text": "Cutting hair myself at home", "option_key": "diy" }
  ],
  "context": {
    "division": "dodaself",
    "action_description": "Personal grooming decision"
  }
}

Response

Returns the full JSON response from the Governance Query Service, including:

• Classification (SOLID/FUZZY/NOVEL)
• Alignment scores
• Reasoning
• Citations

License

MIT