Wiki.js MCP 服务器

用于 Wiki.js 集成的模型上下文协议服务器 - 直接从您的 AI 助手创建和管理 wiki 页面。

从 Claude Code 使用此工具？ 请改用 wikijs-plugin —— 它将此服务器（移植到 Python）与 docs-wiki 技能合并为一个 可通过 Claude Code 市场机制安装的单一插件，无需手动克隆/构建/配置 步骤。配置从此仓库的 .env 移至 ~/.wikijs-plugin/.env（通过 /wikijs-plugin:setup 设置）；运行时从 Node.js 18+ 改为 Python 3.11+；工具名称 （wikijs_create_page，...）保持不变。此仓库将继续接收修复，并且仍然是 直接运行服务器的方式（参见下面的快速入门），适用于除 Claude Code 之外的任何 MCP 客户端。

迁移现有安装： 将 ~/.claude/mcp-servers/wikijs/.env 复制到 ~/.wikijs-plugin/.env（相同的键，相同的值——无需新的 API 令牌），然后从 ~/.claude.json 中删除旧的 wikijs 条目，以免工具被注册两次。

v2.0.0 - 重大重构

此版本包含遵循 MCP 最佳实践的完全重写：

• TypeScript - 严格模式下的完整类型安全

• 现代 SDK - 使用 MCP SDK v1.24+ 及 McpServer.tool() API

• Zod 验证 - 所有工具的运行时输入验证

• 服务前缀工具 - 所有工具使用 wikijs_ 前缀以确保命名空间清晰

• 工具注解 - 正确的 readOnlyHint、destructiveHint 等

• 分页支持 - 列表操作返回 has_more、next_offset、total_count

• 字符限制 - 大内容会被截断并附有清晰提示

Related MCP server: mediawiki-mcp-server

文档

完整文档与常见问题解答

综合指南包括：

• 安装说明

• 配置示例

• 所有 7 个 MCP 工具及其参数

• GraphQL API 集成详情

• 故障排除指南

快速入门

对于除 Claude Code 之外的任何 MCP 客户端（关于 Claude Code 请参见上面的说明）：

# 1. Clone repository
git clone https://github.com/markus-michalski/wikijs-mcp-server.git
cd wikijs-mcp-server

# 2. Install dependencies
npm install

# 3. Build TypeScript
npm run build

# 4. Configure environment
cp .env.example .env
# Edit .env with your Wiki.js API credentials

# 5. Point your MCP client's config at dist/index.js and restart it

要求

• Node.js 18+

• Wiki.js 实例（v2.x 或 v3.x）

• 具有页面管理权限的 Wiki.js API 令牌

可用工具

开发

# Development with hot-reload
npm run dev

# Build for production
npm run build

# Type checking
npm run typecheck

项目结构

wikijs-mcp-server/
├── src/
│   ├── index.ts           # Main server entry point
│   ├── constants.ts       # Shared constants (CHARACTER_LIMIT, etc.)
│   ├── types.ts           # TypeScript type definitions
│   ├── schemas/           # Zod validation schemas
│   ├── services/          # API client and error handling
│   └── tools/             # Tool implementations
├── dist/                  # Compiled JavaScript
├── evaluation.xml         # MCP evaluation test questions
└── package.json

许可证

MIT 许可证 - 详见 LICENSE

作者

Markus Michalski

• 网站：markus-michalski.net

• GitHub：@markus-michalski

链接

• 完整文档（英文）

• 完整文档（德文）

• 更新日志