contexture-mcp

# Contexture [简体中文](README.zh-CN.md) · [Handbook](docs/handbook.md) · [Specification](spec/README.md) · [Changelog](CHANGELOG.md) Implementations: Python (this repository) · [TypeScript](https://github.com/CarterShi01/contexture-mcp-typescript) · [Go](https://github.com/CarterShi01/contexture-mcp-go) Contexture is a Python framework for exposing a large application capability graph to agents without placing every tool and instruction in the model's context at once. You declare Roles, Skills, and Tools; Contexture compiles an immutable graph and serves a small, fixed MCP gateway that discloses only the branch an agent chooses. The same application runtime can back explicit REST routes for human interfaces. Contexture is a Controller layer: it does not contain an agent loop, call a model, or replace your business services. - Python 3.11–3.14 - MCP stdio and Streamable HTTP - Typed and marked with `py.typed` - Apache-2.0 - Stable 1.0 public API governed by Semantic Versioning ## Install With [uv](https://docs.astral.sh/uv/): ```bash uv tool install contexture-mcp contexture --version ``` Or add it to a Python project: ```bash uv add contexture-mcp # or: python -m pip install contexture-mcp ``` To pin this release, request `contexture-mcp==1.0.0`. ## Five-minute application ```bash contexture new hello-context cd hello-context uv sync uv run contexture check ``` The authoring model is deliberately small: ```python from contexture import Contexture, Role, Skill, Tool class CheckStatus(Tool): def __init__(self) -> None: super().__init__( name="check-status", description="Return the status of one service.", read_only=True, ) async def invoke(self, service: str) -> dict[str, str]: return {"service": service, "status": "ready"} class Diagnose(Skill): def __init__(self) -> None: super().__init__( name="diagnose", description="Diagnose an unhealthy service…