内容
confluence2md-mcp` - MCP 服务器，用于 `confluence2md` 索引
[](github.com/gkoos/confluence2md-mcp/actions/workflows/ci.yml)
[](https://github.com/gkoos/confluence2md-mcp/releases)
[](https://github.com/gkoos2md-mcp/blob/main[
MCP 服务器，暴露 [confluence2md-indexhttps://github.com/gkoos/confluence2md-indexer)功能给任何兼容 MCP 的客户端。作为本地标准输入/输出服务器运行，查询从 [conmd](https://github.comos/confluence2md) 导出构建的 SQLite 索引带有评分元数据的排名结果。
## `confluence2md的一部分
`confluence2md-mcp` 是三工具本地 知识管道的第三步。它由 [`confluence2md-indexer`](https://github.com/g/confluence2md-indexer构建的 SQLite 索索引来自 [`confluence2https://github.com/gkoos/confluence2md) 的输出通过 MCP 向 AI 客户端提供服务。有关完整架构，请参见/platform.md](docs/platform 要求
- 由 [confluence2md-indexer](github.com/gkoos/coner) 构建的 SQLite 索引
- 源内容必须使用 [`confluence2md`](https://github.com/gkofluence2md) 元数据格式 — 其他格式不受支持
从 [Releases](../../) 下载您平台的二进制文件，并将其放在您的 `PATH` 中。
### VS Code
在中创建或编辑 `.vscp.json`：
```{
"servers": {
"confluence2md":type": "stdio",
"command": "confluence2cp",
"args "env": {
"CONFLUENCE_INDEX_DB": "//confluence2md-index.db }
}
}
}
```
> 命令面板中的 `M Add Server` 也有效。
### Claude Code
```bash
mcp add confluence2md \
confluence2md-mcp \
-e CONFLUENCE_INDEX_DB=/path/to/confluence2md-index.db
```
**WSL 注意：** 使用 Linux 二进制文件，而不是 Windows `.exe` — `.exe` 不会继承 WSL 环境变量。数据库路径必须是原生 Linux 路径（例如 `/home/user/confluence2md-index.db`），而不是 `/mnt/c/`，以避免 NTFS 挂 SQLite 锁定问题 Codex CLI
添加到 `~/.codex`：
```json
"mcpServers": {
"confluence2md": "command": "confluence2md-mcp",
" "env": {
"CONFLUENCE_INDEX_DBpath/to/confluence2md-index }
}
}
}
```
## 工具
confluence.search`
从本地搜索索引的 Confluence| 参数 | 必需 | 描述 |
|---|---|---|
| `query` | ✓ | 搜索查询文本 |
| `dbPath` | | 覆盖数据库路径（默认为 `CONFLUENCE_INDEX_DB`） |
| `mode` | | `hybrid`（默认）\| `lexical` \| `vector` |
| `fusion` | | `weighted`（默认）\| `rrf` |
| `alpha` | | 加权融合 alpha `[0..1]`，默认 `0.70` |
| `rrfK` | | RRF k 常数，默认 `60` |
| `topK` | | 排名候选人，默认 `10` |
| `limit` | | 返回的最大结果数 |
| `offset` | | 结果偏移量 |
| `candidateK` | | 每个检索通道的候选人数，默认 `50` |
| `expand` | | 上下文扩展块计数 |
| `spaceKey` | | 按空间键过滤 |
| `pageId` | | 按页面 ID 过滤 |
| `fromDate` | | 下限 `YYYY-MM-DD` |
| `toDate` | | 上限 `YYYY-MM-DD` |
响应包括 `schemaVersion`、`count`、`total` 和带有每个块评分分解的 `results` 数组。
## 开发
### 构建
```bash
# Linux / macOS / WSL
go build -o bin/confluence2md-mcp .
# Windows
go build -o bin/confluence2md-mcp.exe .
# 跨编译 Linux 二进制文件（从 Windows）
GOOS=linux GOARCH=amd64 go build -o bin/confluence2md-mcp-linux-amd64 .
```
> 如果模块下载失败，出现 `403` 错误，请设置 `GOPROXY=direct`。
### 测试
```bash
go test ./... -run TestMCPStdioSmoke -v
```
## 故障排除
- **无结果：** 验证 `CONFLUENCE_INDEX_DB` 指向包含 `chunks_fts` 和 `embeddings` 表的已构建索引。
- **WSL + Windows 二进制文件：** 使用 Linux 二进制文件和原生 Linux 数据库路径 — 请参见上面的 WSL 注意。
- **聊天中未显示工具：** 在注册后重启您的 MCP 客户端。
