Crate rivets_mcp 

MCP server for rivets issue tracking.

This crate provides an MCP (Model Context Protocol) server that exposes rivets issue tracking functionality to AI assistants like Claude.

Quick Start

Run the server:

rivets-mcp

Configure in Claude Code (~/.config/claude-code/mcp.json):

{
  "mcpServers": {
    "rivets": {
      "command": "rivets-mcp",
      "args": []
    }
  }
}

Architecture

The server uses the rmcp crate for MCP protocol handling and directly wraps the IssueStorage trait from the rivets crate.

Tools

Context Management

• set_context - Set the workspace root for all operations
• where_am_i - Show current workspace context

Issue Queries

• ready - Find unblocked tasks ready to work on
• list - List issues with filters
• show - Show issue details with dependencies
• blocked - Get blocked issues with their blockers

Issue Modification

• create - Create a new issue
• update - Update issue fields
• close - Mark an issue as complete
• dep - Add a dependency between issues

Debugging

Enable debug logging with the RUST_LOG environment variable:

RUST_LOG=debug rivets-mcp

Re-exports

pub use error::Error;

pub use error::Result;

pub use server::RivetsMcpServer;

Modules

context

Workspace context management for the MCP server.

error

Error types for the rivets MCP server.

models

MCP models.

server

MCP server implementation.

tools

MCP tool implementations.