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.0.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.0-py3-none-any.whl (23.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: codesteward_mcp-0.5.0.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.0.tar.gz
Algorithm Hash digest
SHA256 c9ff94d95cc0be92b404a93b575c8b45a808b86bcfa88bb0d2a295dc9d063749
MD5 d780060bb83cecdb829ddd405fe70da1
BLAKE2b-256 2c26ea1e0fd4b291ee237e3366f09348fba7263e3c53ff9582ed012c76f27fcd

See more details on using hashes here.

Provenance

The following attestation bundles were made for codesteward_mcp-0.5.0.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.0-py3-none-any.whl.

File metadata

  • Download URL: codesteward_mcp-0.5.0-py3-none-any.whl
  • Upload date:
  • Size: 23.5 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 bb02658668c3da4f1089a3c1c4046c6d4f1900cd4c14f36d8fe7682677718f38
MD5 178102537b6d91344addc84a49e06259
BLAKE2b-256 b18ead711d23420249d5122c113864208c4d6df10046d6930526cccfdd362ee9

See more details on using hashes here.

Provenance

The following attestation bundles were made for codesteward_mcp-0.5.0-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