rivets_mcp/lib.rs
1//! MCP server for rivets issue tracking.
2//!
3//! This crate provides an MCP (Model Context Protocol) server that exposes
4//! rivets issue tracking functionality to AI assistants like Claude.
5//!
6//! # Quick Start
7//!
8//! Run the server:
9//!
10//! ```bash
11//! rivets-mcp
12//! ```
13//!
14//! Configure in Claude Code (`~/.config/claude-code/mcp.json`):
15//!
16//! ```json
17//! {
18//! "mcpServers": {
19//! "rivets": {
20//! "command": "rivets-mcp",
21//! "args": []
22//! }
23//! }
24//! }
25//! ```
26//!
27//! # Architecture
28//!
29//! The server uses the `rmcp` crate for MCP protocol handling and directly
30//! wraps the `IssueStorage` trait from the rivets crate.
31//!
32//! # Tools
33//!
34//! ## Context Management
35//! - `set_context` - Set the workspace root for all operations
36//! - `where_am_i` - Show current workspace context
37//!
38//! ## Issue Queries
39//! - `ready` - Find unblocked tasks ready to work on
40//! - `list` - List issues with filters
41//! - `show` - Show issue details with dependencies
42//! - `blocked` - Get blocked issues with their blockers
43//!
44//! ## Issue Modification
45//! - `create` - Create a new issue
46//! - `update` - Update issue fields
47//! - `close` - Mark an issue as complete
48//! - `dep` - Add a dependency between issues
49//!
50//! # Debugging
51//!
52//! Enable debug logging with the `RUST_LOG` environment variable:
53//!
54//! ```bash
55//! RUST_LOG=debug rivets-mcp
56//! ```
57
58pub mod context;
59pub mod error;
60pub mod models;
61pub mod server;
62pub mod tools;
63
64pub use error::{Error, Result};
65pub use server::RivetsMcpServer;