Metadata-Version: 2.4
Name: mrlesmithjr-mcp-common
Version: 0.1.0
Summary: Shared utilities for mrlesmithjr MCP servers: logging, config, paths, errors
Author-email: Larry Smith Jr <mrlesmithjr@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/mrlesmithjr/mcp
Project-URL: Repository, https://github.com/mrlesmithjr/mcp
Project-URL: Bug Tracker, https://github.com/mrlesmithjr/mcp/issues
Keywords: mcp,claude,ai
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: ruff>=0.4; extra == "dev"
Dynamic: license-file

# mrlesmithjr-mcp-common

Shared utilities for mrlesmithjr personal MCP servers.

Import as `mcp_common`.

## Modules

| Module | Purpose |
|--------|---------|
| `mcp_common.logging` | `configure_logging()` forcing stderr output (required for stdio transport) |
| `mcp_common.server` | `build_server(name, instructions)` and `run_stdio(mcp)` |
| `mcp_common.config` | `load_layered_config(tool_name, env_map)` with config.json/env precedence |
| `mcp_common.paths` | `config_dir()`, `config_file()`, `data_dir()` XDG path resolvers |
| `mcp_common.errors` | `tool_error()`, `error_json()`, `safe_tool` decorator |

## Install

This package is a workspace member and is installed automatically via `uv sync` at the repo root.
It is not intended for standalone PyPI distribution.
