feat: add duckflow-mcp MCP server with install script and agent instructions#1
Open
feat: add duckflow-mcp MCP server with install script and agent instructions#1
Conversation
…uctions Co-authored-by: warnes <6144863+warnes@users.noreply.github.com> Agent-Logs-Url: https://github.com/Warnes-Innovations/duckflow/sessions/8111d8de-fc8a-4971-b559-b42d61b0e030
Copilot
AI
changed the title
[WIP] Implement OBO server for the ducktyping tools
feat: add duckflow-mcp MCP server with install script and agent instructions
Mar 24, 2026
warnes
approved these changes
Mar 24, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Exposes duckflow's annotation extraction, stitching, and Mermaid rendering tools as an MCP server so AI agents (Copilot, Codex, Claude Code, Cline) can drive duckflow workflows directly.
MCP server (
duckflow/server.py)Five FastMCP tools mirroring the CLI surface:
duckflow_extractincludeglobs,matchfilter,stitchedflagduckflow_extract_textduckflow_stitchduckflow_mermaidduckflow_mermaid_textAll tools return
ERROR: <message>strings on failure rather than raising, consistent with the MCP tool contract. Repo-existence is validated eagerly.Package changes
pyproject.toml: new[mcp]optional dependency group (mcp>=1.0), newduckflow-mcpconsole script entry pointuvx --from . duckflow-mcporduckflow-mcpafterpip install -e ".[mcp]"Agent instruction templates (
templates/agent-setup/)AGENTS.md/CLAUDE.md— Codex, Cline, and Claude Code workflow rulescopilot/copilot-instructions.md— Copilot workspace instructionscopilot/skills/duckflow/SKILL.md— skill definition with tool reference tablecopilot/prompts/duckflow.prompt.md—/duckflowprompt with annotate / update / review / regenerate workflowInstall script (
install.sh)Interactive bash script modelled on
oboe-mcp/install.sh. Prompts for client selection (Copilot / Codex / Claude Code / Cline / all) and install scope (user-level vs. project directory), then merges the MCP server entry and instruction blocks into each client's config without clobbering existing content.Tests
34 new unit tests in
tests/test_mcp_server.pycovering all five tools: valid extraction, glob filtering, match filtering, stitched graph edges, incompatible-status edge suppression, error paths for nonexistent paths and malformed JSON.📍 Connect Copilot coding agent with Jira, Azure Boards or Linear to delegate work to Copilot in one click without leaving your project management tool.