mcp-common 0.4.9__tar.gz

mcp_common-0.4.9/.github/FUNDING.yml

@@ -0,0 +1 @@
+github: [lesleslie]

mcp_common-0.4.9/.gitignore

@@ -0,0 +1,158 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+venv/
+ENV/
+env/
+.venv/
+
+# Testing
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+coverage.xml
+*.cover
+.hypothesis/
+
+# Type checking
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pytype/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Ruff
+.ruff_cache/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Documentation builds
+docs/_build/
+site/
+
+# Hatch
+.hatch/
+/.benchmarks/
+/.claude/
+/.envrc
+/.mcp.json
+/.crackerjack/
+/coverage.json
+/.complexipy_cache/
+/.jbeval/
+/NOTES.md
+/.oneiric_cache/
+
+# Crackerjack patterns
+
+
+
+
+# Build/Distribution
+# Caches
+# Coverage
+# Crackerjack specific
+# Development
+*$py.class
+*.cover
+*.egg
+*.egg-info/
+*.py[cod]
+*.pyc
+*.so
+*.swo
+*.swp
+*~
+.DS_STORE
+.DS_Store
+.Python
+.coverage
+.coverage*
+.coverage.*
+.crackerjack-*
+.dmypy.json
+.eggs/
+.env
+.env.*.local
+.env.local
+.hatch/
+.hypothesis/
+.idea/
+.installed.cfg
+.mypy_cache/
+.nox/
+.pytest_cache/
+.pytype/
+.ruff_cache/
+.tox/
+.venv/
+.vscode/
+/.benchmarks/
+/.claude/
+/.complexipy_cache/
+/.crackerjack/
+/.envrc
+/.jbeval/
+/.mcp.json
+/.oneiric_cache/
+/NOTES.md
+/build/
+/coverage.json
+/dist/
+ENV/
+MANIFEST
+__pycache__/
+build/
+coverage.xml
+crackerjack-ai-debug-*.log
+crackerjack-debug-*.log
+develop-eggs/
+dist/
+dmypy.json
+docs/_build/
+downloads/
+eggs/
+env/
+htmlcov/
+lib/
+lib64/
+parts/
+sdist/
+site/
+var/
+venv/
+wheels/

mcp_common-0.4.9/AGENTS.md

@@ -0,0 +1,31 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+
+The production code lives under `mcp_common/` with subpackages for `adapters`, `config`, `security`, `ui`, and `cli`. Shared type hints ship via `py.typed`. Tests sit in `tests/`, mixing unit coverage (`test_http_client.py`, `test_config_*`) with scenario suites such as `tests/performance/`. Example servers for manual validation are under `examples/`, while architecture notes and implementation guides live in `docs/`. Build artifacts (`dist/`, `htmlcov/`) should stay out of PRs.
+
+## Build, Test, and Development Commands
+
+Install dev tooling with `uv pip install -e ".[dev]"` to match the lockfile. Key commands (run with `uv run`):
+
+- `pytest --cov=mcp_common --cov-report=html` for the full test matrix.
+- `ruff check` and `ruff format` for linting and auto-format.
+- `mypy mcp_common tests` for static typing.
+- `crackerjack --all` to execute the quality gate used in CI.
+  Use `uv run pre-commit run --all-files` before pushing; hooks invoke bandit, codespell, and other safety nets.
+
+## Coding Style & Naming Conventions
+
+Follow PEP 8 with 4-space indents and 100-character line limits (configured in Ruff). Prefer explicit type hints and async-first patterns; new adapters should follow the Oneiric pattern with direct instantiation and lifecycle methods. Modules and packages use snake_case; classes stick to PascalCase; async tools keep `*_tool` or `_adapter` suffixes for clarity. Use global instance patterns with proper initialization in `main()`.
+
+## Testing Guidelines
+
+Pytest powers the suite; name files `test_*.py` and async tests `async def test_*`. Maintain ≥90% coverage, extending fixtures in `tests/conftest.py` when possible. For performance-sensitive features, mirror the structure in `tests/performance/`. Generate local coverage reports with `uv run pytest --cov ...` and ensure Rich UI assertions remain stable by using the helper utilities in `tests/test_ui_panels.py`.
+
+## Commit & Pull Request Guidelines
+
+Commit history follows Conventional Commits (e.g., `feat: add redis adapter`, `fix(test): adjust rate limit assertion`). Each PR should describe scope, link relevant issues, list new adapters/settings, and note test commands executed. Include screenshots or terminal captures when UI panels change. Verify pre-commit hooks pass before requesting review.
+
+## Security & Configuration Notes
+
+Guard secrets by using MCPBaseSettings with YAML + environment variables—never hard-code keys. Validate new regexes with `uv run python -m crackerjack.tools.validate_regex_patterns`. Update `docs/` when configuration surfaces change so downstream MCP servers stay in sync.

mcp_common-0.4.9/CHANGELOG.md

@@ -0,0 +1,158 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.4.9] - 2026-01-21
+
+### Changed
+
+- Update config, core, deps, docs, tests
+
+## [0.4.8] - 2026-01-05
+
+### Changed
+
+- Update dependencies
+
+## [0.4.7] - 2026-01-05
+
+### Changed
+
+- Update core, deps
+
+## [0.4.6] - 2026-01-03
+
+### Changed
+
+- Update core, deps, tests
+
+## [0.4.5] - 2026-01-03
+
+### Changed
+
+- Update deps, docs
+
+### Fixed
+
+- Resolve all ruff violations for crackerjack compliance
+
+### Internal
+
+- Session checkpoint - Phase 3 migration complete
+- Session cleanup - optimize repository after Phase 3 migration
+
+## [0.4.4] - 2026-01-02
+
+### Added
+
+#### New Server Module (`mcp_common/server/`)
+
+- `BaseOneiricServerMixin` - Reusable server lifecycle methods with template pattern
+  - `_init_runtime_components()` - Initialize Oneiric runtime components
+  - `_create_startup_snapshot()` - Create server startup snapshots
+  - `_create_shutdown_snapshot()` - Create server shutdown snapshots
+  - `_build_health_components()` - Build health check components
+  - `_extract_config_snapshot()` - Extract config for snapshots
+- `check_serverpanels_available()` - Check if mcp_common.ui module exists
+- `check_security_available()` - Check if mcp_common.security module exists
+- `check_rate_limiting_available()` - Check if FastMCP rate limiting exists
+- `get_availability_status()` - Get all dependency statuses as dict
+- `create_runtime_components()` - Factory for Oneiric runtime initialization
+- All availability functions cached with `@lru_cache` for performance
+
+#### CLI Factory Enhancements
+
+- `MCPServerCLIFactory.create_server_cli()` - Support server_class pattern
+  - Bridges gap between handler and server_class patterns
+  - Enables all MCP servers to use production-ready factory
+  - Maintains backward compatibility with existing handler pattern
+
+#### Documentation
+
+- `docs/SERVER_INTEGRATION.md` - Comprehensive integration and migration guide
+  - Architecture patterns (server class vs handler functions)
+  - Migration guide from oneiric.core.cli
+  - Before/after code examples showing 100+ line savings per server
+  - Complete usage examples and best practices
+- `docs/PHASE1_COMPLETE_SUMMARY.md` - Detailed Phase 1 completion summary
+
+#### Testing
+
+- 35 new tests for server module (all passing, 100% pass rate)
+- 97.83% coverage on base.py
+- 91.30% coverage on runtime.py
+- 77.78% coverage on availability.py
+- Integration tests with actual Oneiric runtime components
+
+### Changed
+
+- Enhanced CLI factory to support both handler and server_class patterns
+- Improved documentation structure with integration guides
+
+### Deprecated
+
+- `oneiric.core.cli.MCPServerCLIFactory` - Use `mcp_common.cli.MCPServerCLIFactory.create_server_cli()` instead
+
+## [0.4.1] - 2025-12-27
+
+### Changed
+
+- Update config, core, deps, docs, tests
+
+## [0.4.0] - 2025-12-27
+
+### Changed
+
+- Update config, core, deps, docs, tests
+
+## [0.3.6] - 2025-12-22
+
+### Changed
+
+- Update config, deps, docs
+
+## [0.3.5] - 2025-12-20
+
+### Changed
+
+- Update config, deps, docs
+
+## [0.3.4] - 2025-12-20
+
+### Changed
+
+- Update config, deps, docs, tests
+
+## [0.3.3] - 2025-11-17
+
+### Changed
+
+- Mcp-common (quality: 68/100) - 2025-11-05 15:15:47
+- Mcp-common (quality: 68/100) - 2025-11-09 03:08:23
+- Update config, deps, docs, tests
+
+### Documentation
+
+- config: Update CHANGELOG, pyproject, uv
+
+## [0.3.2] - 2025-11-05
+
+### Documentation
+
+- config: Update CHANGELOG, pyproject, uv
+
+## [0.3.1] - 2025-10-31
+
+### Fixed
+
+- test: Update 66 files
+
+## [0.3.0] - 2025-10-31
+
+### Fixed
+
+- Fix ruff check issues and improve code quality
+- test: Update 36 files