Metadata-Version: 2.5
Name: huaweicloud-mcp-core
Version: 1.0.0
Summary: Shared core library for Huawei Cloud MCP servers (config, credentials, guardrails, output)
License-Expression: MIT
Requires-Python: >=3.10
Requires-Dist: huaweicloudsdkcore>=3.1
Requires-Dist: huaweicloudsdkiam>=3.1
Requires-Dist: mcp>=2.0
Requires-Dist: pyyaml>=6.0
Description-Content-Type: text/markdown

# huaweicloud-mcp-core

Shared core library for all Huawei Cloud MCP servers in the `huaweicloud-mcp` monorepo.

## Responsibilities

- **config** — unified environment-variable configuration (`McpSettings`)
- **credentials** — `BasicCredentials` / `GlobalCredentials` building with automatic
  project_id resolution via IAM (cached, overridable via `HUAWEICLOUD_PROJECT_ID`)
- **errors** — `McpToolError` and `wrap_sdk_error` for the unified error envelope
- **security** — `ToolRisk` (READ / WRITE / DANGEROUS) and the `@guard` decorator
- **guardrails** — `GuardrailsMiddleware` (read-only mode, resource protection rules,
  output masking, structured JSONL audit); auto-installed by `build_server()`
- **output** — paginated / single-object envelopes with token budget guards
- **server** — `build_server()` / `run_standard()` bootstrap (stdio + streamable-http)

## Usage

```python
from huaweicloud_mcp_core.server import build_server, run_standard

mcp = build_server("myservice")

from myservice.tools import thing  # noqa: F401  (import registers tools)


def main() -> None:
    run_standard(mcp, service_name="myservice")
```

See `docs/development/` in the repository root for the full specification.
