hexagram-mcp-server

A minimal, production-friendly sample MCP server project with PyPI publishing support.

Features

• Minimal MCP server implementation
• Tool + Resource examples
• Modern Python packaging with pyproject.toml
• Console entry point (hexagram-mcp-server)
• Build and publish workflow for PyPI

Quick Start

1. Create and activate a virtual environment.

2. Install dependencies:

   pip install -e .[dev]
   

3. Run the server:

   hexagram-mcp-server
   

Example MCP API

• Tool: get_hexagram() -> str

Build Package

python -m build

After building, artifacts are generated in the dist/ directory.

Publish to PyPI

1. Create a PyPI API token from your PyPI account.

2. Configure your token (recommended):

   set PYPI_TOKEN=pypi-xxxxxxxxxxxxxxxx
   

3. Upload:

   python -m twine upload -u __token__ -p %PYPI_TOKEN% dist/*
   

For TestPyPI, use:

python -m twine upload --repository-url https://test.pypi.org/legacy/ -u __token__ -p %PYPI_TOKEN% dist/*

Publish with GitHub Actions

This template includes .github/workflows/publish.yml and supports PyPI Trusted Publishing.

1. Create your package on PyPI first.
2. In PyPI project settings, configure a Trusted Publisher for your GitHub repository.
3. Create a GitHub Release (published), then workflow will build and publish automatically.

If you prefer token-based upload in CI, you can replace the publish step with twine upload and store token in GitHub Secrets.

Notes Before Publishing

• Update name, authors, and project URLs in pyproject.toml.

• Ensure version is bumped before each release.

• Verify package contents:

  python -m twine check dist/*
  

License

MIT