Apache Incubator CWiki MCP

用于 Apache Incubator Confluence 空间的 MCP 服务器：

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

该服务器为只读，适用于公共 wiki 页面。

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 可禁用缓存。