Skip to main content

Codesteward MCP Graph Server — structural code graph queries over HTTP+SSE or stdio

Project description

codesteward-mcp

MCP server that exposes a structural codebase graph as queryable tools for AI agents.

Depends on codesteward-graph for parsing. See the full documentation and setup guide.

Quick start (zero install)

{
  "mcpServers": {
    "codesteward-graph": {
      "command": "uvx",
      "args": [
        "--from", "codesteward-mcp[graph-all,graphqlite]",
        "codesteward-mcp", "--transport", "stdio"
      ]
    }
  }
}

GraphQLite is the default backend — an embedded SQLite graph database, no server needed. The graph persists to ~/.codesteward/graph.db across sessions.

Install

# Core languages (TypeScript, JavaScript, Python, Java) + GraphQLite
uv pip install "codesteward-mcp[graph,graphqlite]"

# All 14 languages + GraphQLite
uv pip install "codesteward-mcp[graph-all,graphqlite]"

# Neo4j backend (alternative — requires a running Neo4j server)
uv pip install "codesteward-mcp[graph-all]"

# JanusGraph backend (alternative — requires a running JanusGraph server)
uv pip install "codesteward-mcp[graph-all,janusgraph]"

Tools

Tool Description
graph_rebuild Parse a repository into the structural graph
codebase_graph_query Query the graph (lexical, referential, semantic, dependency, raw Cypher/Gremlin)
graph_augment Add agent-inferred relationships to the graph
graph_status Return graph metadata (node/edge counts, last build time)

License

Apache License 2.0 — Copyright (c) 2026, bitkaio LLC

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

codesteward_mcp-0.5.1.tar.gz (20.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

codesteward_mcp-0.5.1-py3-none-any.whl (23.6 kB view details)

Uploaded Python 3

File details

Details for the file codesteward_mcp-0.5.1.tar.gz.

File metadata

  • Download URL: codesteward_mcp-0.5.1.tar.gz
  • Upload date:
  • Size: 20.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for codesteward_mcp-0.5.1.tar.gz
Algorithm Hash digest
SHA256 6e3abcb5f0df6c353ef2f00d4a4c674f4a17e04aacfce9cc5b465a0d237971e0
MD5 ec330fb93edef673f659350eb2db7779
BLAKE2b-256 0ee270dface82f3fbbd4ebd2687edeea5e2e4089cbf9c4e7dcf086fac3be98b0

See more details on using hashes here.

Provenance

The following attestation bundles were made for codesteward_mcp-0.5.1.tar.gz:

Publisher: release.yml on Codesteward/codesteward

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file codesteward_mcp-0.5.1-py3-none-any.whl.

File metadata

  • Download URL: codesteward_mcp-0.5.1-py3-none-any.whl
  • Upload date:
  • Size: 23.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for codesteward_mcp-0.5.1-py3-none-any.whl
Algorithm Hash digest
SHA256 482f46ba50ff9c9cafd02b02bce449d6dc3f938971d0c083189ba9839fa2317a
MD5 fcf5963dd91c3420001e5637992b8f14
BLAKE2b-256 f7fb85b1de952de0bd5d408d19e1feacd46dd63c2acd9bd18dfee158efdccb07

See more details on using hashes here.

Provenance

The following attestation bundles were made for codesteward_mcp-0.5.1-py3-none-any.whl:

Publisher: release.yml on Codesteward/codesteward

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page