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

@@ -4,6 +4,7 @@ version = "0.9.4"
description = "MCP server for beads issue tracker."
readme = "README.md"
requires-python = ">=3.11"
license = {text = "MIT"}
dependencies = [
"fastmcp==2.12.4",
"pydantic==2.12.0",
@@ -12,16 +13,28 @@ dependencies = [
authors = [
{name = "Beads Contributors"}
]
keywords = ["beads", "mcp", "claude", "issue-tracker", "ai-agent"]
maintainers = [
{name = "Beads Contributors"}
]
keywords = ["beads", "mcp", "claude", "issue-tracker", "ai-agent", "model-context-protocol"]
classifiers = [
"Development Status :: 3 - Alpha",
"Intended Audience :: Developers",
"License :: OSI Approved :: MIT License",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.11",
"Programming Language :: Python :: 3.12",
"Programming Language :: Python :: 3.13",
"Topic :: Software Development :: Libraries :: Python Modules",
"Topic :: Software Development :: Bug Tracking",
]
[project.urls]
Homepage = "https://github.com/steveyegge/beads"
Repository = "https://github.com/steveyegge/beads"
Documentation = "https://github.com/steveyegge/beads/blob/main/integrations/beads-mcp/README.md"
Issues = "https://github.com/steveyegge/beads/issues"
[project.scripts]
beads-mcp = "beads_mcp.server:main"