Skip to content

Conversation

@hmans
Copy link
Owner

@hmans hmans commented Dec 13, 2025

Summary

  • Add beans mcp command that runs an MCP (Model Context Protocol) server
  • Single beans_graphql tool exposes the full GraphQL API to AI assistants
  • Uses official Go MCP SDK (github.com/modelcontextprotocol/go-sdk)

Status

🚧 Work in Progress - The MCP server works, but we're still exploring how to best prime Claude to use beans for work tracking without manual CLAUDE.md setup or hooks.

What works

  • MCP server starts and accepts connections via stdio
  • beans_graphql tool with full schema in description
  • Lazy core initialization (graceful errors when not in a beans project)
  • Tests passing

What's still being explored

  • How to make Claude proactively use beans (MCP server instructions aren't surfaced by Claude Code)

Test plan

  • Unit tests for MCP functionality
  • Manual test with Claude Code MCP integration
  • Explore alternatives for priming Claude

Usage

claude mcp add beans --transport stdio -- beans mcp

- Add `beans mcp` command that runs a stdio MCP server
- Single `beans_graphql` tool wrapping the GraphQL engine
- Tool description includes full schema and usage docs
- Uses official Go MCP SDK (github.com/modelcontextprotocol/go-sdk)
- Lazy core initialization for graceful behavior in non-project dirs
- Export ExecuteQuery and add helper functions for schema creation
- Add comprehensive tests for MCP functionality

Closes beans-kp3h
@hmans hmans marked this pull request as draft December 20, 2025 09:31
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.

2 participants