granit-tools-mcp

Local MCP server for the Granit framework — gives AI assistants (Claude Code, Cursor, Windsurf) structured access to documentation, code navigation, and NuGet package metadata.

Built as a .NET 10 dotnet tool with SQLite FTS5 for full-text search and the Model Context Protocol SDK.

Full documentation — getting started, tools reference, configuration, architecture, usage patterns, contributing.

Tools (9)

Documentation

Tool	Description
docs_search	FTS5 search — returns ID, title, snippet
docs_get	Full article content by ID
docs_list_patterns	Architecture patterns list

Code navigation

Tool	Description
code_search	Search symbols across .NET and TS
code_get_api	Public API of a type with signatures
code_get_graph	Project/package dependency graph
code_list_branches	Branches with committed code indexes

NuGet packages

Tool	Description
nuget_list	Granit.* packages with version/downloads
nuget_get	Versions, deps, frameworks, license

Install

dotnet tool install --global Granit.Tools.Mcp

Use with Claude Code

{
  "mcpServers": {
    "granit": {
      "command": "granit-tools-mcp"
    }
  }
}

Use with Cursor / Windsurf

Add the MCP server in Settings > MCP Servers:

• Name: granit
• Command: granit-tools-mcp

Architecture

Claude Code ──stdio──> Granit.Tools.Mcp (local .NET 10 tool)
                         |-- Docs ---------> SQLite FTS5
                         |                     ^ llms-full.txt (auto-generated)
                         |-- Code ---------> .mcp-*-index.json (GitHub raw)
                         |-- NuGet --------> api.nuget.org
                         +-- Branches -----> api.github.com

Data sources

Source	Origin	Cache
Documentation	granit-fx.dev/llms-full.txt	SQLite (4h refresh)
.NET code index	GitHub raw (branch-aware)	In-memory (12h)
Front code index	GitHub raw (branch-aware)	In-memory (12h)
NuGet packages	NuGet Search API	In-memory (12h)
NuGet package info	NuGet Registration API	In-memory (6h)

Branch detection

The tool reads .git/HEAD from the current working directory and uses the detected branch for code index tools by default. Explicit branch parameter overrides this.

Development

dotnet build
dotnet run --project src/Granit.Tools.Mcp

ADRs

• ADR-001 — JSON index + Cloudflare Workers (superseded)
• ADR-002 — Code navigation & NuGet packages (superseded)
• ADR-003 — Local .NET tool with SQLite FTS5

License

Apache-2.0