cd

CompoundDocs — Claude Code Plugin

A Claude Code plugin (cd) that implements a GraphRAG knowledge base for C#/.NET documentation. It bundles an HTTP-based MCP server backed by graph traversal (Amazon Neptune), vector search (AWS OpenSearch Serverless), and LLM synthesis (Amazon Bedrock) to provide semantic Q&A over documentation with source attribution.

How It Works

The plugin exposes a single MCP tool, rag_query, that orchestrates a multi-stage retrieval pipeline:

Query → Embedding Generation → KNN Vector Search → Graph Traversal → LLM Synthesis → Answer + Sources

1. Embed the user query using Amazon Bedrock Titan Embed v2 (1024-dim vectors)
2. Search for relevant document chunks via KNN in OpenSearch Serverless
3. Enrich results by traversing concept relationships in Neptune
4. Synthesize a final answer with source citations using Claude on Bedrock

Prerequisites

• .NET 9.0 SDK
• AWS credentials configured for Neptune, OpenSearch Serverless, and Bedrock access
• Docker (optional, for building/running the production container image)

Quick Start

# Build
dotnet build

# Run the MCP server
dotnet run --project src/CompoundDocs.McpServer/CompoundDocs.McpServer.csproj

# Run all tests
dotnet test

Project Structure

src/
├── CompoundDocs.McpServer     # MCP server app (HTTP transport), RagQueryTool, processing pipeline, resilience
├── CompoundDocs.Common        # Shared models, graph relationships, config loading, logging
├── CompoundDocs.GraphRag      # RAG pipeline orchestration (IGraphRagPipeline)
├── CompoundDocs.Vector        # IVectorStore — AWS OpenSearch Serverless KNN search
├── CompoundDocs.Graph         # IGraphRepository — Amazon Neptune (openCypher)
├── CompoundDocs.Bedrock       # IBedrockEmbeddingService + IBedrockLlmService
├── CompoundDocs.GitSync       # Git repository monitoring via LibGit2Sharp
└── CompoundDocs.Worker        # Background document processing service

tests/
├── CompoundDocs.Tests.Unit         # xUnit + Moq + Shouldly
├── CompoundDocs.Tests.Integration  # Service integration tests
└── CompoundDocs.Tests.E2E          # End-to-end workflow and MCP protocol compliance tests

MCP Tool

rag_query

Performs RAG-based question answering with source attribution.

Parameter	Type	Default	Description
query	string	(required)	The question to answer
maxResults	int	5	Max source documents to use (1–20)

Response:

{
  "success": true,
  "data": {
    "query": "How does dependency injection work?",
    "answer": "...",
    "sources": [
      {
        "documentId": "...",
        "chunkId": "...",
        "filePath": "docs/dependency-injection.md",
        "relevanceScore": 0.95
      }
    ],
    "relatedConcepts": ["service lifetime", "constructor injection"],
    "confidenceScore": 0.87
  }
}

Configuration

Configuration is loaded from multiple sources (highest priority wins):

1. Code defaults — CompoundDocsServerOptions provides sensible defaults
2. Global config — ~/.claude/.csharp-compounding-docs/global-config.json
3. Project config — .csharp-compounding-docs/config.json (per-repository)
4. Environment variables — override any config file values

Config loading is handled by ConfigurationLoader in CompoundDocs.Common.

Key Sections

Section	Description
Authentication	API key auth — keys (comma-separated), header name, enabled flag
EmbeddingCache	In-memory cache — max items (10,000), TTL (24h), optional disk persistence
Resilience	Polly policies — retry, circuit breaker, timeout settings
Chunking	Document chunking — chunk size (1000), overlap (200), paragraph boundaries

Environment Variables

Variable	Description
ASPNETCORE_ENVIRONMENT	Runtime environment (Production, Development)
COMPOUNDDOCS_LOG_LEVEL	Log level (set in the Dockerfile)
COMPOUNDDOCS_API_KEYS	API keys (used in the Helm chart deployment template)

Authentication

The server uses API key authentication by default. Keys are validated from the X-API-Key header or Authorization: Bearer header.

{
  "Authentication": {
    "Enabled": true,
    "HeaderName": "X-API-Key",
    "ApiKeys": "key1,key2,key3"
  }
}

Set Enabled to false to disable authentication for local development. The /health endpoint is always anonymous.

Docker

# Pull pre-built image from GHCR
docker pull ghcr.io/csharp-compound-engineering/csharp-compound-engineering/mcp-server:latest

# Or build locally
docker build -t compound-docs-mcp .