Confluence Wiki MCP Server

项目简介

面向 macOS 的 Confluence Wiki 内容获取 MCP 服务器，通过托管 Chrome Profile 自动管理认证，无需手动配置 Cookie。

Related MCP server: confluence-mcp-server

功能

• 获取 Confluence Wiki 页面正文，支持 Markdown、HTML 和纯文本格式

• 按关键词检索 Wiki 内容，支持限定 Space 和标题搜索

• 获取页面附件、评论、引用和资源列表

• 聚合获取完整需求证据包（上下文、评论、引用、资产）

• 托管 Chrome Profile 自动登录，无需手动复制 Cookie

• Cookie 凭据值仅作为 HTTPS Cookie 请求头附加到精确源 https://wiki.imgo.tv（含同源重定向），永不进入日志、错误信息、认证状态/快照或 MCP 响应

系统要求

• macOS

• Node.js 18.17 及以上

• Google Chrome（已安装）

安装

npm install -g confluence-wiki-mcp-server

安装后可通过 confluence-wiki-mcp 命令使用。

首次登录

confluence-wiki-mcp auth login
confluence-wiki-mcp auth status

首次运行打开独立的本地 Chrome Profile，完成一次交互式 Wiki 登录。后续 MCP 进程自动重用会话，正常工具调用不会打开可见浏览器。认证仅使用托管 Chrome Profile，不需要也不支持通过环境变量或文件配置凭据。

confluence-wiki-mcp auth logout --confirm

登出需要 --confirm 确认，仅删除托管的标记 Profile。

MCP 配置

{
  "mcpServers": {
    "wiki-imgo": {
      "type": "stdio",
      "command": "confluence-wiki-mcp",
      "args": []
    }
  }
}

此配置适用于 cc-switch 导入。

工具

使用规范

• 不得在日志、异常或 MCP 响应中记录或输出凭据信息。

• wiki_health_check 为本地检查，不访问网络，不探测服务端。

• wiki_auth_status 可主动探测 Profile 状态，但返回的快照永远不含凭据值。

• 登出必须调用 wiki_auth_logout 并传 confirm=true，或 CLI --confirm，仅删除托管的标记 Profile。

• 所有请求（含重定向）仅允许 https://wiki.imgo.tv 精确源，拒绝其他源。

• 401/403 响应会自动标记认证失效，提示运行 confluence-wiki-mcp auth login。

• 托管 Chrome Profile 仅存在于本地 ~/Library/Application Support/confluence-wiki-mcp/browser-profile；认证凭据从不通过 MCP 网络传输。

常见错误

开发验证

npm ci
npm test
npm run build
npm pack --dry-run

开发验证包含完整自动化测试套件和构建检查。交互式 macOS Chrome 登录为外部手工验证项，无法在 CI 中覆盖。

npm Trusted Publishing 前置条件

正式发布使用 release.yml 工作流通过 OIDC Trusted Publishing 发布到 npm，附带 provenance 证明。以下前置条件全部完成并验证通过之前，Trusted Publisher 引导发布和 v0.2.0 版本必须视为未完成。首次发布前需满足：

1. 创建公开 GitHub 仓库，推送默认分支，确保 .github/workflows/release.yml 已包含在仓库中。

2. 使用可控的临时凭据发布一个受审计的启动包（如 0.1.0），该启动包发布不创建 GitHub Release。

3. 在 npm 包设置中配置 Trusted Publisher：工作流文件名为 release.yml，环境为 npm，允许 npm publish。

4. 上述步骤完成后，创建 v0.2.0 GitHub Release 以触发 OIDC 自动发布。

请勿在发布工作流中添加 npm token 或其他仓库密钥。

许可证

MIT