Wikijs MCP Server

🚀 📚 WikiJS MCP Server

这个工具可以将Claude连接到你的Wiki.js文档系统！它能让Claude直接读取和更新Wiki.js页面，就像是给Claude开启了访问团队知识库的权限，对于保持文档更新或快速查找信息来说非常实用。

🚀 快速开始

本工具安装完成后，你可以向Claude发出以下指令：

• 🔍 搜索：在你的Wiki中查找特定主题。
• 📖 阅读：读取文档页面内容。
• ✏️ 更新：用新信息更新现有页面。
• 📝 创建：创建新的文档。
• 🗂️ 整理：通过移动页面来组织文档结构。
• 🗑️ 删除：删除过时的页面。

📦 安装指南

前提条件

在开始安装前，请确保你已经具备以下条件：

• ✅ 已安装 Git（点击此处下载）
• ✅ 已安装 Python 3.8 或更高版本（点击此处下载）
• ✅ 已安装 Claude Code（点击此处获取）
• ✅ 拥有 Wiki.js 网站的访问权限（需要一个API密钥，后续会说明获取方法）

步骤 1：下载代码

打开终端（Windows系统使用命令提示符，Mac系统使用终端），并运行以下命令：

git clone https://github.com/your-username/wikijs-mcp.git
cd wikijs-mcp

💡 使用建议

如果你遇到“command not found”错误，请确保已经安装了Git！

步骤 2：获取Wiki.js API密钥

1. 以管理员身份登录你的Wiki.js网站。
2. 导航到管理页面（通常位于顶部菜单）。
3. 点击左侧侧边栏的API访问选项。
4. 如果API处于禁用状态，请点击开关启用它。
5. 点击**“+ 新API密钥”**。
6. 为其命名，例如“Claude Integration”。
7. 选择以下权限：
   • ✅ 读取页面
   • ✅ 写入页面
   • ✅ 管理页面（如果你希望Claude能够创建/删除页面）
8. 点击创建并复制API密钥，下一步会用到它！

⚠️ 重要提示

请将此密钥妥善保存，因为你无法再次查看它！

步骤 3：配置连接

1. 创建配置文件：

cp .env.example .env

2. 使用任意文本编辑器（如记事本、TextEdit、VS Code等）打开 .env 文件。
3. 将示例值替换为你的实际信息：

WIKIJS_URL=https://your-wiki-site.com
WIKIJS_API_KEY=paste-your-api-key-here

📌 示例：

WIKIJS_URL=https://docs.mycompany.com
WIKIJS_API_KEY=ey1234567890abcdef...

步骤 4：安装Python依赖项

运行以下命令来安装工具所需的依赖项：

pip install -e .

💡 使用建议

• 如果你遇到“pip: command not found”错误，请尝试使用 pip3。
• 在Mac系统上，你可能需要使用 python3 -m pip install -e .。

步骤 5：测试连接

让我们确保一切正常！运行以下命令：

python -m wikijs_mcp.server

你应该会看到类似以下的输出：

WikiJS MCP Server starting...
Connected to Wiki.js at https://your-wiki-site.com
Ready to accept connections!

按 Ctrl+C 停止服务。

💻 使用示例

与Claude Code配合使用

最棒的是，Claude Code会自动检测到这个MCP服务器！ 该仓库包含一个特殊的 .mcp.json 文件，Claude Code会自动读取它。你只需：

1. 在 wikijs-mcp 文件夹中打开Claude Code。
2. Claude将自动获得访问你的Wiki.js的权限！

尝试以下命令

连接成功后，你可以向Claude提出以下请求：

"Search my wiki for information about deployment procedures"
"Read the page at /docs/getting-started"
"Update the troubleshooting guide with a new solution for login issues"
"Create a new page at /docs/api/webhooks with webhook documentation"

🔧 手动配置（高级）

如果你使用的是其他MCP客户端或需要自定义设置，可以参考以下配置：

标准安装配置

{
  "mcpServers": {
    "wikijs": {
      "command": "python",
      "args": ["-m", "wikijs_mcp.server"],
      "env": {
        "WIKIJS_URL": "https://your-wiki-site.com",
        "WIKIJS_API_KEY": "your-api-key"
      }
    }
  }
}

Docker用户配置

{
  "mcpServers": {
    "wikijs": {
      "command": "docker",
      "args": ["compose", "run", "--rm", "-T", "wikijs-mcp-server", "python3", "-m", "wikijs_mcp.server"],
      "cwd": "/path/to/wikijs-mcp"
    }
  }
}

🆘 常见问题及解决方案

“Connection refused” 或 “Cannot connect to Wiki.js”

• ✅ 检查你的 WIKIJS_URL 末尾是否没有斜杠。
• ✅ 确保你的计算机可以访问Wiki.js网站。
• ✅ 验证Wiki.js管理面板中API是否已启用。

“Authentication failed” 或 “Invalid API key”

• ✅ 仔细检查你是否完整复制了API密钥。
• ✅ 确保密钥前后没有多余的空格。
• ✅ 验证API密钥是否具有正确的权限。

“Module not found” 错误

• ✅ 确保你在 wikijs-mcp 文件夹中运行了 pip install -e .。
• ✅ 尝试使用 python3 代替 python。

Claude Code 无法识别Wiki.js工具

• ✅ 确保你从 wikijs-mcp 文件夹中运行Claude Code。
• ✅ 检查 .mcp.json 文件是否存在。
• ✅ 尝试重启Claude Code。

📚 可用工具参考

Claude连接成功后可以执行以下操作：

🛠️ 开发者指南

运行测试

# 安装开发依赖项
pip install -e ".[dev]"

# 运行所有测试
pytest

# 运行测试并生成覆盖率报告
pytest --cov=wikijs_mcp

代码质量检查

# 格式化代码
black wikijs_mcp/ tests/

# 类型检查
mypy wikijs_mcp/

📄 许可证

本项目采用MIT许可证，你可以自由使用和修改！

💬 需要帮助？

• 查看上述 常见问题及解决方案 部分。
• 参考 Wiki.js文档。
• 如果你仍然遇到问题，请在GitHub上提交一个issue！

祝你文档编写愉快！ 🎉