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

Uploaded Python 3

File details

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

File metadata

  • Download URL: codesteward_mcp-0.4.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.4.2.tar.gz
Algorithm Hash digest
SHA256 71fad20b02d5b49e8558d7293458731dfa0943b786010ad209be337be973db61
MD5 932df8e62acee0f384d0d7a39112a307
BLAKE2b-256 71a1f90137d19c1ee03e3be51c92b1872cf67c2e370ffeb38b218bc39432ccff

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: codesteward_mcp-0.4.2-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.4.2-py3-none-any.whl
Algorithm Hash digest
SHA256 fef7bb9164beb28019935b112f5f3f179024276e06ecec48a39bbe9c04730db6
MD5 7a790a85c0a1c0a2bf5dc8146ec2a81f
BLAKE2b-256 3aa5f2fb0e5bf35e33c7a236f4c2eac78a30b37073b00b444b675f0134b03c96

See more details on using hashes here.

Provenance

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