iflow-mcp_lns2905-beads-village

# Beads Village [](https://www.npmjs.com/package/beads-village) [](https://www.npmjs.com/package/beads-village) Multi-agent MCP server for **task coordination** and **file locking** between AI agents. Combines [Beads](https://github.com/steveyegge/beads) (issue tracking) + built-in Agent Mail (messaging) to enable multiple agents to work on the same codebase without conflicts. > 💡 **Note:** Messaging is built-in. No external mail server required. Inspired by [MCP Agent Mail](https://github.com/Dicklesworthstone/mcp_agent_mail) concept. ## Use Cases - **Multi-agent development**: Multiple AI agents working on different parts of a codebase - **Task queue management**: Agents claim and complete tasks from a shared queue - **File conflict prevention**: Lock files before editing to prevent merge conflicts - **Cross-agent communication**: Send messages between agents for coordination --- ## Quick Start ### 1. Install Prerequisites ```bash pip install beads # Required: Beads CLI node --version # Required: Node.js 16+ ``` ### 2. Install Beads Village ```bash npx beads-village # Recommended # or: npm install -g beads-village # or: pip install beads-village ``` ### 3. Configure Your IDE/Agent <details> <summary><strong>Claude Desktop</strong></summary> Edit `claude_desktop_config.json`: - Windows: `%APPDATA%\Claude\claude_desktop_config.json` - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` ```json { "mcpServers": { "beads-village": { "command": "npx", "args": ["beads-village"] } } } ``` </details> <details> <summary><strong>Claude Code (CLI)</strong></summary> ```bash claude mcp add beads-village -- npx beads-village ``` Or create `.mcp.json` in project root: ```json { "mcpServers": { "beads-village": { "command": "npx", "args": ["beads-village"] …