Tharga.MongoDB.Mcp 2.10.12

Tharga.MongoDB.Mcp

Exposes Tharga.MongoDB monitoring data and admin actions over MCP (Model Context Protocol). Plugs into Tharga.Mcp so that Claude, Cursor, and other MCP clients can inspect collections, diagnose slow queries, rebuild indexes, and (optionally) read or modify documents — without SSH'ing to a prod box for mongosh.

Install

dotnet add package Tharga.MongoDB.Mcp

builder.Services.AddThargaMcp(mcp => mcp.AddMongoDB());
app.UseThargaMcp();

By default only metadata is exposed. Opt in to data tools explicitly:

builder.Services.AddThargaMcp(mcp => mcp.AddMongoDB(o =>
{
    o.DataAccess = DataAccessLevel.DataRead;       // adds get_document, list_documents, find_duplicates, explain
    // o.DataAccess = DataAccessLevel.DataReadWrite; // also adds clean
}));

The provider is registered on the System MCP scope, so it only surfaces to system-level callers (e.g. an admin API key) — not to per-team users.

What's exposed

Resources

• mongodb://collections — every registered collection with status, indexes, document count
• mongodb://monitoring — recent calls, slow queries, latency
• mongodb://clients — connected MongoDB driver clients

Tools (Metadata level — default)

• mongodb.touch — initialise a collection (assure indexes, etc.)
• mongodb.rebuild_index — drop & recreate a named index
• mongodb.drop_index, mongodb.reset_cache, mongodb.clear_call_history, mongodb.compare_schema

Tools (DataRead)

• mongodb.get_document — raw BSON-as-JSON for a single document by id (auto-detects ObjectId / Guid / string)
• mongodb.list_documents — paged listing with optional filter and sort
• mongodb.find_duplicates, mongodb.explain

Tools (DataReadWrite)

• mongodb.clean — apply collection cleaners

Atlas (optional)

When you set MongoDbMcpOptions.Atlas to a MongoDbApiAccess (Public/Private API key + Group/Project ID), the package additionally registers read-only MongoDB Atlas Administration tools on the System scope:

builder.Services.AddThargaMcp(mcp => mcp.AddMongoDB(o =>
{
    o.Atlas = new MongoDbApiAccess
    {
        PublicKey  = "<atlas-public-key>",
        PrivateKey = "<atlas-private-key>",
        GroupId    = "<atlas-project-id>",
    };
}));

Atlas tools are gated by the same DataAccessLevel.Metadata minimum as the rest of the package. Leaving Atlas unset keeps the surface entirely opt-in.

Documentation

Full docs and configuration reference: github.com/Tharga/MongoDB.