How mechantchulo/ripple-mcp works
Ripple is an MCP server that gives IBM Bob structured access to project operations context. In the principal workflow, a developer asks Bob to investigate; Bob chooses Ripple tools, receives evidence from Git, CI, deployment data, service health, and project documentation, then correlates it and reports a diagnosis. Ripple also supports GitHub pull-request creation and status checks. The demo FastAPI service supplies a health endpoint. Tool behavior is documented in the README and registration is visible in server/main.py; some tool implementations and demo routes were not sampled, so uncertain internal wiring is omitted.
Main entry points: main.py Ripple MCP · ci_tools.py CI status · github_tools.py Pull request tools · git_tools.py Recent changes
Components 18
MCP interface
- Ripple MCP
server/main.py
Operational evidence
- Recent changes
server/tools/git_tools.py - CI status
server/tools/ci_tools.py - Deployment info
server/tools/deployment_tools.py - Service health
server/tools/health_tools.py - Docs search
server/tools/docs_tools.py - Project Git repository
- GitHub Actions
- CI fixture
demo_data/ci_status.json - Deployment fixture
demo_data/deployment.json - Project Markdown
docs
GitHub changes
- Pull request tools
server/tools/github_tools.py - GitHub REST API
Demo service
- Demo health endpoint
demo_app/app/routes - FastAPI app
demo_app/app/main.py - Database availability
demo_app/app/services/database.py
Other components
- Developer
- IBM Bob
Connections 19
- Developer → IBM Bob: asks
- IBM Bob → Ripple MCP: calls tools
- Ripple MCP → Recent changes: dispatches
- Ripple MCP → CI status: dispatches
- Ripple MCP → Deployment info: dispatches
- Ripple MCP → Service health: dispatches
- Ripple MCP → Docs search: dispatches
- Ripple MCP → Pull request tools: dispatches
- Recent changes → Project Git repository: reads history
- CI status → GitHub Actions: queries CI
- CI status → CI fixture: reads fallback
- Deployment info → Deployment fixture: reads record
- Docs search → Project Markdown: searches
- Service health → Demo health endpoint: checks health
- Demo health endpoint → FastAPI app: serves route
- FastAPI app → Database availability: checks availability
- Pull request tools → GitHub REST API: creates or checks PR
- Pull request tools → Project Git repository: reads branch or remote
- Ripple MCP → IBM Bob: returns evidence