Mediawiki Mcp Server

MediaWiki MCP Server

将 AI 助手连接到任意 MediaWiki 维基，也可以直接从终端编写脚本。使用自然语言或 wiki CLI 搜索、阅读和编辑维基内容。

三种使用方式：

1. MCP 服务 — Claude Desktop、Claude Code、Cursor、ChatGPT、n8n、VS Code、Google ADK 或任何兼容 MCP 的工具。参阅 SETUP.md。
2. wiki CLI — 使用相同的 API 客户端和身份验证，无需 AI。适用于 Shell 管道、CI 检查和 cron 作业。参阅 CLI.md。
3. Claude Code 插件 — /plugin marketplace add olgasafonova/mediawiki-mcp-server 可将维基技能直接添加到 Claude Code。参阅 .claude-plugin/README.md。

---

文档

文档	内容
QUICKSTART.md	2 分钟内完成运行
SETUP.md	各工具的配置（Claude Desktop、Cursor、ChatGPT、n8n、VS Code、Google ADK）
CLI.md	wiki 命令行参考
TOOLS.md	完整的工具参考（按类别划分，共 43 个工具）
DEPLOYMENT.md	HTTP 传输、安全性、端点、环境变量
TIETO_SETUP.md	连接到 Tieto 的 Public 360° Wiki（适合初学者）
WIKI_USE_CASES.md	按角色分类的详细工作流
ARCHITECTURE.md	系统设计
CONTRIBUTING.md	如何参与贡献
SECURITY.md	安全策略
CHANGELOG.md	版本历史

---

可以做什么？

同一操作既可以通过提示词（借助 MCP）执行，也可以直接在 Shell 中执行（借助 wiki CLI）：

目标	向 AI 提示	在终端中执行
搜索维基	“我们的维基对入职流程有何说明？”	wiki search "onboarding"
阅读页面	“显示入门页面”	wiki page "Getting Started"
查找失效链接	“文档页面上有失效链接吗？”	wiki links broken --json
查找过时内容	“哪些页面已超过 90 天未更新？”	wiki stale-pages --days 90
获取交叉链接建议	“哪些页面与 API 参考相似？”	wiki similar "API Reference"
审计维基健康状况	“检查维基的健康状况”	wiki audit --json
发布 Markdown	“将此 README 发布到维基”	wiki publish README.md "Page Title"
删除姓名	“在团队页面上划掉 John Smith”	wiki replace "Team" --find "John Smith" --replace "<s>John Smith</s>"

完整工具列表请参阅 TOOLS.md。CLI 会返回类型化退出代码，便于在 CI 中进行分支处理 — 参阅 CLI.md。

---

30 秒快速开始

1. 获取二进制文件。 从 Releases 下载，或运行 go build -o mediawiki-mcp-server .（需要 Go 1.24+）。
2. 找到维基 API URL — 通常为 https://your-wiki.com/api.php。Wikipedia 的地址是 https://en.wikipedia.org/w/api.php。访问 Special:Version 进行确认。
3. 将其连接到 AI 工具 — 根据客户端选择相应配置，参阅 SETUP.md。

阅读公共维基无需登录。私有或企业维基以及编辑操作需要机器人密码 — 参阅 SETUP.md#editing-wiki-pages。

---

示例提示词

📖 更多示例： 请参阅 WIKI_USE_CASES.md，了解按角色划分的详细工作流（内容编辑者、文档管理员、开发者）。

搜索和阅读：

• “我们的 Wiki 对部署有什么说明？”
• “简要介绍一下 Configuration 页面”
• “一次性获取 Main Page、FAQ 和 Setup 的内容”

跟踪更改：

• “本周更新了哪些页面？”
• “显示最近两个版本之间的差异”
• “本月最活跃的编辑者有哪些？”

检查质量：

• “这个页面有失效链接吗？”
• “查找没有任何页面链接到的孤立页面”
• “查找与 Installation Guide 类似的页面”
• “查找过去 90 天内未更新的页面”

页面管理（需要身份验证）：

• “将 ‘Old Guide’ 重命名为 ‘Updated Guide’”
• “在 Team 页面上删除 John Smith”
• “将 Release Notes 中的 ‘version 2.0’ 替换为 ‘version 3.0’”

文件上传和搜索（需要身份验证）：

• “从 URL 将这张图片上传到 Wiki”
• “将这个本地文件上传到 Wiki”（Agent 会对字节进行 Base64 编码；无需公开 URL）
• “在 File:Annual-Report.pdf 中搜索 ‘budget’”

转换 Markdown：

• “将此 README 转换为 Wiki 格式”
• “使用 Tieto 品牌样式和 CSS 进行转换”（使用 theme="tieto"，添加 add_css=true）

---

PDF 搜索设置

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

平台	安装命令
macOS	brew install poppler
Ubuntu/Debian	apt install poppler-utils
RHEL/CentOS	yum install poppler-utils
Windows	choco install poppler

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

验证安装：

pdftotext -v

---

兼容性

平台	传输方式	状态
Claude Desktop (Mac/Windows)	stdio	✅ 支持
Claude Code CLI	stdio	✅ 支持
Cursor	stdio	✅ 支持
VS Code	stdio	✅ 支持
ChatGPT	HTTP	✅ 支持
n8n	HTTP	✅ 支持
Google ADK	stdio / HTTP	✅ 支持

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

---

故障排除

常见问题及解决方法请参见 SETUP.md#troubleshooting。如需深入诊断，HTTP 服务提供 /health、/ready 和 /status 端点——请参见 DEPLOYMENT.md。

---

开发

有关构建、测试和贡献的信息，请参见 CONTRIBUTING.md。有关系统设计、软件包布局和数据流，请参见 ARCHITECTURE.md。

推送前运行完整检查：

go test -race -failfast ./...
golangci-lint run ./...

集成测试通过 docker-compose.test.yml 针对真实的 MediaWiki 实例运行。工作流请参见 CONTRIBUTING.md。

---

喜欢这个项目吗？

如果这个服务为你节省了时间，不妨在 GitHub 上给它一个 ⭐。这有助于其他人发现这个项目。

更多 MCP 服务

查看我的其他 MCP 服务：

服务	描述	Star 数
gleif-mcp-server	访问 GLEIF LEI 数据库。查询公司身份信息，验证法人实体。
miro-mcp-server	使用 AI 控制 Miro 白板。管理白板、图表、思维导图等。
nordic-registry-mcp-server	访问北欧商业登记处。查询挪威、丹麦、芬兰和瑞典的公司。
productplan-mcp-server	与你的 ProductPlan 路线图交互。查询 OKR、创意和发布计划。
tilbudstrolden-mcp	北欧杂货优惠搜寻。查找优惠、规划餐食、追踪支出。
mcp-servercard-go	用于 SEP-2127 Server Cards 的 Go 库。支持 MCP 服务的预连接发现。

---

许可证

MIT 许可证

致谢

• 使用 Go MCP SDK 构建
• 由 MediaWiki API 提供支持