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:
@@ -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
|
||||
|
||||
|
||||
Reference in New Issue
Block a user