Skip to content

v0.1.0

Choose a tag to compare

@zazencodes zazencodes released this 25 Jun 13:05
· 31 commits to main since this release

Added

  • Initial release of random-number-mcp
  • FastMCP v2.0 server implementation
  • Six random number utility tools:
    • random_int - Generate random integers using random.randint()
    • random_float - Generate random floats using random.uniform()
    • random_choices - Choose items from a list using random.choices() with optional weights
    • random_shuffle - Shuffle items into a new list using random.sample()
    • secure_token_hex - Generate cryptographically secure hex tokens using secrets.token_hex()
    • secure_random_int - Generate cryptographically secure integers using secrets.randbelow()
  • Comprehensive input validation and error handling
  • Type hints throughout the codebase
  • Complete test suite with pytest
  • Documentation and examples
  • PyPI packaging with uv build system
  • MIT License

Features

  • JSON-RPC 2.0 transport over STDIO
  • Support for Python 3.10+
  • Extensible architecture for adding new tools
  • Both standard and cryptographically secure random functions
  • Comprehensive error handling with descriptive messages
  • Full MCP protocol compliance

Developer Experience

  • Modern Python packaging with pyproject.toml
  • Code quality tools (ruff, mypy)
  • Comprehensive test coverage
  • Developer documentation
  • GitHub Actions for CI/CD