@codeconscience/mcp-server

Model Context Protocol server for CodeConscience.

Exposes the rules discovered by CodeConscience as MCP tools so Claude Code (and any other MCP-compatible agent) can query a project's conventions, constraints, and design rationale at edit time.

Install

You don't usually need to install this directly — the codeconscience CLI bundles it and runs it via codeconscience serve. Install it explicitly only if you want to embed the server in your own tooling:

npm install @codeconscience/mcp-server

Use via the CLI (recommended)

Add this to your Claude Code MCP config:

{
  "mcpServers": {
    "codeconscience": {
      "command": "codeconscience",
      "args": ["serve"]
    }
  }
}

Tools exposed

| Tool | Purpose | |------|---------| | query_rules | Query rules by category, type, or status | | get_conventions | Summary of active naming/structural conventions | | get_rationale | Design rationale extracted from git history | | check_violation | Check a file path or symbol name against active rules | | suggest_fix | Suggest a fix for a naming violation |

Programmatic embedding

import { createServer, startServer } from '@codeconscience/mcp-server';

// Quick path: stdio transport, runs forever
await startServer('/path/to/project');

// Or get the server instance and connect a custom transport
const server = createServer('/path/to/project');
// await server.connect(yourTransport);

License

Released under the PolyForm Noncommercial License 1.0.0. Free for personal, hobby, research, educational, and non-profit use. Commercial use requires a separate license.