Beans MCP

Name: Beans MCP
Author: selfagency

@selfagency

Beans MCP について

MCP (Model Context Protocol) server for Beans issue tracker. Provides programmatic and CLI interfaces for AI-powered interactions with Beans workspaces.

#beans #issue-tracker #issues #markdown #memory

基本情報

カテゴリ

その他

トランスポート

stdio

公開者

selfagency

投稿者

Daniel Sieradski

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "beans": {
      "command": "npx",
      "args": [
        "-y",
        "@selfagency/beans-mcp@latest",
        "/path/to/your/repo"
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is Beans MCP?

Beans MCP is a Model Context Protocol server for the Beans issue tracker. It provides programmatic and CLI interfaces for AI-powered interactions with Beans workspaces, enabling AI assistants to read, create, update, and manage issue beans.

How to use Beans MCP?

Run npx @selfagency/beans-mcp /path/to/workspace from the command line. Optional parameters include --workspace-root, --cli-path, --port, and --log-dir. The server exposes 13 public MCP tools for interacting with beans.

Key features of Beans MCP

Initializes, lists, views, and archives bean workspaces
Creates and bulk-creates beans with parent support
Updates bean metadata and body with concurrency control
Supports bulk updates and batch delete operations
Queries beans with filters, sort, and GraphQL passthrough
Marks markdown checklist tasks complete automatically

Use cases of Beans MCP

AI agents managing issue tracking workflows programmatically
Batch creation or updating of related beans under a shared parent
Automating closure or reopening of beans with cascading status on descendants
Integrating Beans with VS Code via the companion extension
Performing complex queries and generating Copilot instructions from workspace data

FAQ from Beans MCP

What version of Beans CLI is supported?

The server checks against Beans CLI version 0.4.2 at startup. If versions differ, a warning is printed to stderr but startup continues.

How does Beans MCP handle path validation?

All file and log operations validate paths to stay within the workspace or VS Code log directory. The .beans/ prefix is automatically stripped from input paths.

Are bulk operations atomic?

No. beans_bulk_create and beans_bulk_update are best-effort: each item is processed sequentially and failures are reported per-item in the result array.

Does closing a parent bean affect its children?

Yes. Closing a parent bean via beans_update with status completed or scrapped cascades the same status to all descendants.

Does Beans MCP cache query results?

Unfiltered list results are cached with a short burst TTL and a timestamp-probe refresh strategy. Mutation tools immediately invalidate the cache.

「その他」の他のコンテンツ

MCP Registry

modelcontextprotocol

A community driven registry service for Model Context Protocol (MCP) servers.

7.0K

Production-ready MCP integrations for AI applications

Klavis-AI

Klavis AI: MCP integration platforms that let AI agents use tools reliably at any scale

5.8K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

EverArt