MediaWiki MCP 服务器

将您的 AI 助手连接到任何 MediaWiki wiki。使用自然语言搜索、阅读和编辑 wiki 内容。

兼容： Claude Desktop、Claude Code、Cursor、ChatGPT、n8n 以及任何兼容 MCP 的工具。

文档

Related MCP server: productplan-mcp-server

您可以做什么？

连接后，只需询问您的 AI：

开始使用

第 1 步：下载

选项 A：下载预构建的二进制文件（最简单）

前往 Releases 并下载适用于您平台的版本。

选项 B：从源码构建（需要 Go 1.24+）

git clone https://github.com/olgasafonova/mediawiki-mcp-server.git
cd mediawiki-mcp-server
go build -o mediawiki-mcp-server .

第 2 步：查找您 Wiki 的 API URL

您 wiki 的 API URL 通常是：

提示： 访问您 wiki 上的 Special:Version 以查找确切的 API 端点。

第 3 步：配置您的 AI 工具

选择您的工具：

Claude Desktop

适用于 Mac 和 Windows。初始设置后无需终端。

1. 打开配置文件：

   open ~/Library/Application\ Support/Claude/claude_desktop_config.json

   如果文件不存在，请创建它。

2. 添加此配置（替换路径和 URL）：

   {
     "mcpServers": {
       "mediawiki": {
         "command": "/path/to/mediawiki-mcp-server",
         "env": {
           "MEDIAWIKI_URL": "https://your-wiki.com/api.php"
         }
       }
     }
   }

3. 重启 Claude Desktop（退出并重新打开）

4. 测试它： 询问 “在 wiki 中搜索入门指南”

1. 打开配置文件：

   %APPDATA%\Claude\claude_desktop_config.json

   如果文件不存在，请创建它。

2. 添加此配置（替换路径和 URL）：

   {
     "mcpServers": {
       "mediawiki": {
         "command": "C:\\path\\to\\mediawiki-mcp-server.exe",
         "env": {
           "MEDIAWIKI_URL": "https://your-wiki.com/api.php"
         }
       }
     }
   }

3. 重启 Claude Desktop（退出并重新打开）

4. 测试它： 询问 “在 wiki 中搜索入门指南”

Claude Code CLI

最快的设置方式。一条命令即可完成。

claude mcp add mediawiki /path/to/mediawiki-mcp-server \
  -e MEDIAWIKI_URL="https://your-wiki.com/api.php"

测试它： 询问 “在 wiki 中搜索入门指南”

Cursor

Cursor 内置了 MCP 支持。打开 Cursor Settings > MCP 并添加新服务器，或直接编辑配置文件：

1. 打开配置文件：

   ~/.cursor/mcp.json

2. 添加此配置：

   {
     "mcpServers": {
       "mediawiki": {
         "command": "/path/to/mediawiki-mcp-server",
         "env": {
           "MEDIAWIKI_URL": "https://your-wiki.com/api.php"
         }
       }
     }
   }

3. 重启 Cursor

1. 打开配置文件：

   %USERPROFILE%\.cursor\mcp.json

2. 添加此配置：

   {
     "mcpServers": {
       "mediawiki": {
         "command": "C:\\path\\to\\mediawiki-mcp-server.exe",
         "env": {
           "MEDIAWIKI_URL": "https://your-wiki.com/api.php"
         }
       }
     }
   }

3. 重启 Cursor

ChatGPT

ChatGPT 通过 HTTP 连接。您需要在 ChatGPT 可以访问的机器上运行服务器。

要求： ChatGPT Pro、Plus、Business、Enterprise 或 Education 账户。

设置

1. 以 HTTP 模式启动服务器：

   # Set your wiki URL
   export MEDIAWIKI_URL="https://your-wiki.com/api.php"
   
   # Generate a secure token
   export MCP_AUTH_TOKEN=$(openssl rand -hex 32)
   echo "Save this token: $MCP_AUTH_TOKEN"
   
   # Start the server
   ./mediawiki-mcp-server -http :8080

2. 在 ChatGPT 中：

   • 前往 Settings → Connectors → Advanced → Developer Mode

   • 添加新的 MCP 连接器

   • URL: http://your-server:8080（必须是公开可访问的）

   • Authentication: Bearer token → 粘贴您的令牌

3. 测试它： 询问 “在 wiki 中搜索入门指南”

生产环境： 请参阅 安全最佳实践 以进行 HTTPS 设置。

n8n

n8n 通过 MCP Client Tool 节点使用 HTTP 连接。

设置

1. 以 HTTP 模式启动服务器：

   export MEDIAWIKI_URL="https://your-wiki.com/api.php"
   export MCP_AUTH_TOKEN="your-secure-token"
   ./mediawiki-mcp-server -http :8080

2. 在 n8n 中：

   • 添加一个 MCP Client Tool 节点

   • Transport: HTTP Streamable

   • URL: http://your-server:8080

   • Authentication: Bearer → 您的令牌

3. 为 AI 代理启用（添加到 n8n 环境）：

   N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true

4. 将 MCP Client Tool 连接到 AI Agent 节点。

VS Code

VS Code 通过 Copilot Chat 内置了 MCP 支持。

1. 打开命令面板：Ctrl+Shift+P (Windows) 或 Cmd+Shift+P (Mac)

2. 输入 "MCP: Add Server" 并选择它

3. 选择 "Stdio" 作为传输类型

4. 出现提示时输入二进制文件的路径

5. 命名服务器：mediawiki

这将创建一个 .vscode/mcp.json 文件。添加环境变量：

{
  "servers": {
    "mediawiki": {
      "command": "/path/to/mediawiki-mcp-server",
      "env": {
        "MEDIAWIKI_URL": "https://your-wiki.com/api.php"
      }
    }
  }
}

在 Windows 上，使用带有双反斜杠的 .exe 路径。

重新加载 VS Code，然后通过 Copilot Chat 使用 wiki 工具。

Google ADK

Google 的 Agent Development Kit 通过 stdio 或 Streamable HTTP 连接到 MCP 服务器。

import (
    "os/exec"
    "google.golang.org/adk/tool/mcptoolset"
    "github.com/modelcontextprotocol/go-sdk/mcp"
)

// Create MCP toolset for wiki access
wikiTools, _ := mcptoolset.New(mcptoolset.Config{
    Transport: &mcp.CommandTransport{
        Command: exec.Command("/path/to/mediawiki-mcp-server"),
        Env: []string{
            "MEDIAWIKI_URL=https://your-wiki.com/api.php",
        },
    },
})

// Add to your agent
agent := llmagent.New(llmagent.Config{
    Name:     "wiki-agent",
    Model:    model,
    Toolsets: []tool.Set{wikiTools},
})

首先，以 HTTP 模式启动服务器：

export MEDIAWIKI_URL="https://your-wiki.com/api.php"
./mediawiki-mcp-server -http :8080 -token "your-secret-token"

然后从您的 ADK 代理连接：

import (
    "google.golang.org/adk/tool/mcptoolset"
    "github.com/modelcontextprotocol/go-sdk/mcp"
)

wikiTools, _ := mcptoolset.New(mcptoolset.Config{
    Transport: mcp.NewStreamableHTTPClientTransport("http://localhost:8080"),
})

from google.adk.tools.mcp_tool import MCPToolset, StdioConnectionParams, StdioServerParameters

wiki_tools = MCPToolset(
    connection_params=StdioConnectionParams(
        server_params=StdioServerParameters(
            command="/path/to/mediawiki-mcp-server",
            env={"MEDIAWIKI_URL": "https://your-wiki.com/api.php"},
        )
    )
)

以 HTTP 模式启动服务器，然后：

from google.adk.tools.mcp_tool import MCPToolset, StreamableHTTPConnectionParams

wiki_tools = MCPToolset(
    connection_params=StreamableHTTPConnectionParams(
        url="http://localhost:8080",
        headers={"Authorization": "Bearer your-secret-token"},
    )
)

需要编辑 Wiki 页面？

在公共 wiki 上，无需登录即可阅读。私有/企业 wiki 通常要求所有操作（包括阅读）都需要身份验证。 编辑始终需要机器人密码。

创建机器人密码

1. 登录您的 wiki

2. 前往 Special:BotPasswords（例如 https://your-wiki.com/wiki/Special:BotPasswords）

3. 输入机器人名称：mcp-assistant

4. 勾选这些权限：

   • ✅ 基本权限

   • ✅ 编辑现有页面

5. 点击 Create 并 保存密码（您以后将无法再次看到它）

将凭据添加到您的配置

Claude Desktop / Cursor：

{
  "mcpServers": {
    "mediawiki": {
      "command": "/path/to/mediawiki-mcp-server",
      "env": {
        "MEDIAWIKI_URL": "https://your-wiki.com/api.php",
        "MEDIAWIKI_USERNAME": "YourWikiUsername@mcp-assistant",
        "MEDIAWIKI_PASSWORD": "your-bot-password-here"
      }
    }
  }
}

Claude Code CLI：

claude mcp add mediawiki /path/to/mediawiki-mcp-server \
  -e MEDIAWIKI_URL="https://your-wiki.com/api.php" \
  -e MEDIAWIKI_USERNAME="YourWikiUsername@mcp-assistant" \
  -e MEDIAWIKI_PASSWORD="your-bot-password-here"

示例提示词

📖 更多示例： 请参阅 WIKI_USE_CASES.md 以获取按角色（内容编辑、文档经理、开发人员）划分的详细工作流。

搜索与阅读

• “我们的 wiki 关于部署说了什么？”

• “查找所有提到 API 的页面”

• “向我展示入门指南”

• “列出文档类别中的所有页面”

• “给我一个配置页面的快速概览” ✨

• “一次性获取主页、常见问题解答和设置的内容” ✨

章节与相关内容 ✨

• “向我展示安装指南的章节”

• “从常见问题解答页面获取‘故障排除’章节”

• “查找与 API 参考相关的页面”

• “产品概览页面上有什么图片？”

跟踪更改

• “本周更新了哪些页面？”

• “是谁编辑了发布说明页面？”

• “向我展示最后两个版本之间的差异”

• “本月最活跃的编辑者是谁？” ✨

• “哪些页面被编辑得最频繁？” ✨

检查质量

• “此页面上有损坏的链接吗？”

• “查找没有链接指向它们的孤立页面”

• “检查产品类别中的术语一致性”

• “查找与安装指南类似的页面” ✨

• “比较‘API 版本’在各页面中的记录方式” ✨

• “查找过去 90 天内未更新的页面” ✨

页面管理（需要授权） ✨

• “将‘旧指南’重命名为‘更新指南’”

• “将类别‘API’添加到集成页面”

• “从此页面中删除‘已弃用’类别”

快速编辑（需要授权）

• “在团队页面上划掉 John Smith”

• “在发布说明上将‘版本 2.0’替换为‘版本 3.0’”

• “在架构页面上将‘API 网关’加粗”

文件上传（需要授权） ✨

• “将此图片从 URL 上传到 wiki”

• “将 https://example.com/logo.png 的徽标添加为 Company_Logo.png”

文件搜索 ✨

• “在 File:Annual-Report.pdf 中搜索‘预算’”

• “在 changelog.txt 文件中查找对‘API’的提及”

注意： PDF 搜索需要安装 poppler-utils。请参阅 PDF 搜索设置。

转换 Markdown ✨

• “将此 README 转换为 wiki 格式”

• “将我的发布说明从 Markdown 转换为 MediaWiki”

• “使用 Tieto 品牌和 CSS 进行转换” (使用 theme="tieto", add_css=true)

主题：

• tieto - Tieto 品牌颜色（Hero Blue 标题，黄色代码高亮）

• neutral - 无自定义颜色的简洁输出（默认）

• dark - 针对深色模式优化

查找用户

• “谁是 wiki 管理员？”

• “列出所有机器人账户”

故障排除

“MEDIAWIKI_URL 环境变量是必需的” → 检查您的配置文件是否具有正确的路径和 URL。

“身份验证失败” → 检查用户名格式：WikiUsername@BotName → 验证机器人密码是否已过期 → 确保机器人具有所需的权限

“页面不存在” → 页面标题区分大小写。检查您 wiki 上的确切标题。

工具未出现在 Claude/Cursor 中 → 配置更改后重启应用程序。

ChatGPT 无法连接 → 确保您的服务器是公开可访问的（不仅仅是 localhost） → 检查 Bearer 令牌是否完全匹配

“PDF 搜索需要 'pdftotext'” → 为您的平台安装 poppler-utils（请参阅 PDF 搜索设置）

PDF 搜索设置

PDF 搜索需要来自 poppler-utils 的 pdftotext 工具。文本文件搜索（TXT、MD、CSV 等）无需任何依赖项。

Windows 替代方案： 从 poppler-windows releases 下载二进制文件并添加到 PATH。

验证安装：

pdftotext -v

兼容性

适用于任何 wiki： Wikipedia、Fandom、企业 wiki 或任何 MediaWiki 安装。

高级配置

HTTP 传输选项

对于 ChatGPT、n8n 和远程访问，服务器支持 HTTP 传输。

CLI 标志

|