Apache Incubator CWiki MCP

Servidor MCP para el espacio de Confluence de Apache Incubator:

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

El servidor es de solo lectura y funciona con páginas wiki públicas.

Las respuestas GET se almacenan en caché localmente de forma predeterminada durante 30 días. Utilice force_refresh=true en las herramientas de lectura para omitir la caché en una sola llamada.

Instalación

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

Ejecución

incubator-cwiki-mcp

Para desarrollo local:

python -m incubator_cwiki_mcp.server

Prueba

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

Configuración con Codex o Claude Desktop

Utilice el punto de entrada del módulo de 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"
      }
    }
  }
}

Herramientas

• cwiki_space_info: devuelve metadatos para el espacio de Confluence configurado.

• cwiki_list_pages: enumera las páginas en el espacio Incubator.

• cwiki_search_pages: busca páginas con CQL de Confluence.

• cwiki_get_page: obtiene una página por título o page_id.

• cwiki_get_children: enumera las páginas secundarias de un page_id.

• cwiki_cache_info: muestra la configuración y el tamaño de la caché local.

• cwiki_clear_cache: borra la caché local.

Entorno

• CWIKI_BASE_URL: predeterminado a https://cwiki.apache.org/confluence.

• CWIKI_SPACE_KEY: predeterminado a INCUBATOR.

• CWIKI_CACHE_DIR: predeterminado a .cache/cwiki.

• CWIKI_CACHE_TTL_SECONDS: predeterminado a 2592000 segundos (30 días). Establézcalo en 0 para deshabilitar el almacenamiento en caché.