Apache Incubator CWiki MCP

MCP-сервер для пространства Apache Incubator Confluence:

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

Сервер работает только в режиме чтения и предназначен для публичных страниц вики.

Ответы GET по умолчанию кэшируются локально на 30 дней. Используйте force_refresh=true в инструментах чтения, чтобы обойти кэш для одного вызова.

Установка

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

Запуск

incubator-cwiki-mcp

Для локальной разработки:

python -m incubator_cwiki_mcp.server

Тестирование

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

Настройка с Codex или Claude Desktop

Используйте точку входа модуля Python:

{
  "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"
      }
    }
  }
}

Инструменты

• cwiki_space_info: возвращает метаданные для настроенного пространства Confluence.

• cwiki_list_pages: список страниц в пространстве Incubator.

• cwiki_search_pages: поиск страниц с помощью Confluence CQL.

• cwiki_get_page: получение страницы по заголовку или page_id.

• cwiki_get_children: список дочерних страниц для page_id.

• cwiki_cache_info: отображение настроек и размера локального кэша.

• cwiki_clear_cache: очистка локального кэша.

Окружение

• CWIKI_BASE_URL: по умолчанию https://cwiki.apache.org/confluence.

• CWIKI_SPACE_KEY: по умолчанию INCUBATOR.

• CWIKI_CACHE_DIR: по умолчанию .cache/cwiki.

• CWIKI_CACHE_TTL_SECONDS: по умолчанию 2592000 секунд (30 дней). Установите 0, чтобы отключить кэширование.