Skip to content

Wire read-only MCP server for coding agents (v0.1.2)#19

Merged
Shakargy merged 2 commits into
mainfrom
v0.1.2-mcp-transport
Jul 5, 2026
Merged

Wire read-only MCP server for coding agents (v0.1.2)#19
Shakargy merged 2 commits into
mainfrom
v0.1.2-mcp-transport

Conversation

@Shakargy

@Shakargy Shakargy commented Jul 4, 2026

Copy link
Copy Markdown
Owner

Summary

DevTime memory becomes available to coding agents. dtc mcp start now runs a real MCP server over stdio, so agents like Claude Code can query evidence-backed repository memory instead of guessing.

  • Wires the stdio transport for the three already-implemented read-only tools: list_concepts, explain_concept, get_context_pack
  • MCP SDK is an optional extra (pip install "devtime-ei[mcp]"); the core install stays lean and dtc mcp start fails with a helpful install hint without it
  • dtc mcp preview now honestly separates implemented tools from planned ones
  • README gains a "Use with coding agents (MCP)" section (claude mcp add devtime -- dtc mcp start + .mcp.json snippet)
  • LIMITATIONS/ROADMAP updated: "MCP transport is not wired" is no longer true, so it no longer says that
  • Version bumped to 0.1.2 + release notes (RELEASE_NOTES_v0.1.2.md)

Trust model (unchanged, now enforced by a real server)

  • Read-only: no write tools exposed
  • Local stdio only: no network listener
  • No source code returned: claims, evidence file paths, uncertainty only
  • stdout is reserved for the JSON-RPC stream; all diagnostics go to stderr
  • Outside a scanned repo, tools return a clear not_initialized error and dtc mcp start exits 2 with instructions

Verification

  • 104 tests passing (7 new: tool registration, calls against a scanned demo repo, not-initialized guard, CLI surface)
  • End-to-end verified with the official MCP Python client over stdio against a wheel-installed dtc: initialize handshake, list_tools, and all three tool calls return correct evidence-backed data
  • Wheel smoke both ways: plain wheel degrades gracefully (helpful hint, exit 1), [mcp] extra works fully
  • python -m build + twine check pass; no forbidden artifacts in the wheel

No concept detection, risk review, or scanner behavior changes. No tag, no publish (awaiting approval).

Shakargy added 2 commits July 5, 2026 01:34
dtc mcp start now runs a real MCP server over stdio, exposing the three
implemented read-only tools (list_concepts, explain_concept, get_context_pack)
so coding agents can query local evidence-backed repository memory.

- MCP SDK is an optional extra: pip install "devtime-ei[mcp]" (core stays lean)
- stdout is reserved for the JSON-RPC stream; diagnostics go to stderr
- read-only surface only: no write tools, no network listener, no source code
- tools return a clear not_initialized error outside a scanned repo
- mcp preview separates implemented tools from planned ones (no overclaiming)
- README gains a "Use with coding agents (MCP)" section with Claude Code and
  .mcp.json setup; LIMITATIONS/ROADMAP updated to stop saying "not wired"
- version 0.1.2, release notes added, 104 tests (7 new), end-to-end verified
  with the official MCP Python client against a wheel install
Adds server.json (io.github.shakargy/devtime, pypi package devtime-ei, stdio)
and a manual workflow that publishes it to the official MCP Registry using
GitHub OIDC (no stored secrets). The mcp-name ownership marker is embedded in
the README so the registry can validate the PyPI package.
@Shakargy Shakargy merged commit 717ba45 into main Jul 5, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant