Skip to content

feat: add MCP server for artifact cleanup#17

Open
NotYash1066 wants to merge 1 commit into
kunjee17:mainfrom
NotYash1066:feat/mcp-server
Open

feat: add MCP server for artifact cleanup#17
NotYash1066 wants to merge 1 commit into
kunjee17:mainfrom
NotYash1066:feat/mcp-server

Conversation

@NotYash1066

@NotYash1066 NotYash1066 commented May 11, 2026

Copy link
Copy Markdown

Summary

  • add an irona --mcp stdio Model Context Protocol server
  • expose scan_artifacts and clean_artifacts tools backed by the existing scanner/deleter logic
  • document MCP client configuration and recommend adding Cargo's bin directory to PATH so configs can use command = "irona" instead of a local absolute binary path

Closes #16

Verification

  • cargo test passed: 54 tests
  • pre-commit hook passed: fmt, clippy, build
  • installed binary smoke-tested with MCP initialize and tools/list
  • tested the MCP connection in Codex; Codex discovers the irona tools and scan_artifacts / clean_artifacts work end to end

Notes

This intentionally keeps cleanup destructive only through explicit clean_artifacts path arguments; scan_artifacts is read-only.

Expose irona over stdio MCP while reusing the existing scanner and deleter paths. Document PATH-based configuration so MCP clients can call irona portably instead of hardcoding a user-local binary.

Constraint: MCP clients launch servers by command and args, so the binary must support a non-TUI stdio mode.

Rejected: Separate irona-mcp crate | unnecessary split for two tools that reuse existing core behavior.

Confidence: high

Scope-risk: moderate

Directive: Keep MCP cleanup destructive only through explicit clean_artifacts path arguments; do not make scan_artifacts delete anything.

Tested: cargo test; pre-commit fmt and clippy hook; installed binary smoke-tested with initialize and tools/list; Codex MCP command verified after local config wiring.

Not-tested: End-to-end startup from a freshly restarted Codex process.
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.

feat: MCP server for AI-native artifact management

1 participant