Skip to main content
Glama
Sign In
deenesjakoruzh
wikijs-mcp-server

wikijs-mcp-server

by markus-michalski
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

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: WikiJS 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 令牌

可用工具

工具

描述

注解

wikijs_create_page

使用 Markdown 或 HTML 创建新的 wiki 页面

destructiveHint: false

wikijs_update_page

更新现有页面（内容、标题、标签）

idempotentHint: true

wikijs_get_page

检索完整的页面内容和元数据

readOnlyHint: true

wikijs_list_pages

列出页面，支持分页和过滤

readOnlyHint: true

wikijs_search_pages

跨 wiki 页面进行全文搜索

readOnlyHint: true

wikijs_delete_page

永久删除页面

destructiveHint: true

wikijs_move_page

将页面移动到新路径

destructiveHint: false

开发

# 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

链接

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Related MCP Servers

  • WikiMCP

    raydeStar
    A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server for Wiki.js projects that enables full-text search, page retrieval, and page management capabilities. It allows LLMs to interact with wiki content through specialized tools for searching, listing, and creating pages.
    ISC

  • Wiki.js MCP Server

    heAdz0r
    A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that provides a unified interface to manage Wiki.js pages, users, and groups via GraphQL API, enabling AI agents to create, read, update, and delete content and perform administrative tasks.
    20 npm
    14
    MIT