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

Uploaded Python 3

File details

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

File metadata

  • Download URL: codesteward_mcp-0.5.2.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.2.tar.gz
Algorithm Hash digest
SHA256 ce07d90aa00080afc7b57751a97f93e183054730c6528914729789ed36463b14
MD5 4d97837d6bf02f6920ffb5d201ed9edb
BLAKE2b-256 414d3feabcbb5eb8e429504a96075dfd2e4e92908cd18c6fc58ac9d55fd2a6f3

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: codesteward_mcp-0.5.2-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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 5ef3afcf18abfa104414ec96eef1d6a01d1269a4d0c16f6afa08cfc0de7ff814
MD5 bc6ec583b49ae2d0b17af94922b8ae8d
BLAKE2b-256 107b3d8bc757eb3f64d78f4b4c8d01c65938c05ee91120fffd99bdde2322bb73

See more details on using hashes here.

Provenance

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