feat(mcp): Setup beads-mcp for PyPI distribution

Prepared the beads-mcp package for publishing to PyPI, simplifying installation
for users who want to use the MCP server with Claude Desktop or other MCP clients.

Changes:
- Added LICENSE file (MIT) to integrations/beads-mcp/
- Updated pyproject.toml with PyPI metadata (license, URLs, classifiers)
- Updated README with simplified installation (uv tool install beads-mcp)
- Created PYPI.md with detailed publishing guide
- Updated examples/claude-desktop-mcp/README to reference the production MCP server

Installation is now simplified from:
  git clone && cd && uv sync
to:
  uv tool install beads-mcp

Configuration is simplified from multi-line with --directory args to:
  "command": "beads-mcp"

Tested build successfully. Package ready for:
- Test PyPI: python -m twine upload --repository testpypi dist/*
- Production PyPI: python -m twine upload dist/*

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Steve Yegge
2025-10-14 18:07:07 -07:00
parent d5f1c5f36e
commit 23bbdc7afa
5 changed files with 280 additions and 10 deletions

View File

@@ -1,18 +1,52 @@
# Claude Desktop MCP Server for Beads
> **Note**: This is a reference implementation showing how to integrate bd with Claude Desktop via MCP (Model Context Protocol).
> **Note**: The beads MCP server is now fully implemented! See [integrations/beads-mcp](../../integrations/beads-mcp/) for the production implementation.
## What This Provides
An MCP server that exposes bd functionality to Claude Desktop, allowing Claude to:
An MCP server that exposes bd functionality to Claude Desktop and other MCP clients, allowing Claude to:
- Query ready work
- Create and update issues
- Manage dependencies
- Track discovered work
## Implementation Status
## Quick Start
This is a **documentation stub** showing the intended integration pattern. Full implementation coming soon!
Install the beads MCP server:
```bash
# Using uv (recommended)
uv tool install beads-mcp
# Or using pip
pip install beads-mcp
```
Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
```json
{
"mcpServers": {
"beads": {
"command": "beads-mcp"
}
}
}
```
Restart Claude Desktop and you're done! Claude can now manage your beads issues.
## Full Documentation
See the [beads-mcp README](../../integrations/beads-mcp/README.md) for:
- Installation instructions
- Configuration options
- Environment variables
- Development guide
---
## Original Design Documentation (Historical)
## Planned Features