# Apache Incubator CWiki MCP

MCP server for the Apache Incubator Confluence space:

<https://cwiki.apache.org/confluence/display/INCUBATOR>

The server is read-only and works against public wiki pages.

GET responses are cached locally by default for 30 days. Use `force_refresh=true` on read tools to bypass the cache for a single call.

## Install

```sh
python3 -m venv .venv
. .venv/bin/activate
pip install -e .
```

## Run

```sh
incubator-cwiki-mcp
```

For local development:

```sh
python -m incubator_cwiki_mcp.server
```

## Test

```sh
pip install -e ".[dev]"
make check
```

## Configure With Codex or Claude Desktop

Use the Python module entrypoint:

```json
{
  "mcpServers": {
    "incubator-cwiki": {
      "command": "<Path to CwikiMCP>/.venv/bin/python",
      "args": ["-m", "incubator_cwiki_mcp.server"],
      "env": {
        "CWIKI_BASE_URL": "https://cwiki.apache.org/confluence",
        "CWIKI_SPACE_KEY": "INCUBATOR"
      }
    }
  }
}
```

## Tools

- `cwiki_space_info`: return metadata for the configured Confluence space.
- `cwiki_list_pages`: list pages in the Incubator space.
- `cwiki_search_pages`: search pages with Confluence CQL. Use `title_only=true` to match page titles only (faster and more precise for finding a specific page by name).
- `cwiki_get_page`: fetch a page by title or `page_id`.
- `cwiki_get_children`: list child pages for a `page_id`.
- `cwiki_cache_info`: show local cache settings and size.
- `cwiki_clear_cache`: clear the local cache.

## Environment

- `CWIKI_BASE_URL`: defaults to `https://cwiki.apache.org/confluence`.
- `CWIKI_SPACE_KEY`: defaults to `INCUBATOR`.
- `CWIKI_CACHE_DIR`: defaults to `.cache/cwiki`.
- `CWIKI_CACHE_TTL_SECONDS`: defaults to `2592000` seconds (30 days). Set to `0` to disable caching.