beans-mcp

Return to top

Run the server ​

bash

npx @selfagency/beans-mcp /path/to/workspace

Or with explicit flags:

bash

npx @selfagency/beans-mcp --workspace-root /path/to/workspace --cli-path beans --port 39173

CLI arguments ​

• workspace-root (positional) or --workspace-root / --workspace

• --cli-path <path>

• --port <number>

• --log-dir <path>

• -h, --help

Workspace resolution order ​

• Explicit CLI workspace argument

• MCP roots from connected client

• Current working directory

First commands to run from your MCP client ​

• beans_init (optional, if workspace not initialized)

• beans_query with operation: refresh

• beans_view on specific IDs

Getting Started ​

Requirements ​

• Node.js 18+

• pnpm 10+

• Beans CLI available in PATH (or provide --cli-path)