使用说明
MediaWiki MCP服务器
将您的AI助手连接到任何MediaWiki维基,或直接从终端编写脚本。使用自然语言或 wiki CLI。
使用它的三种方法:
- MCP服务器 --Claude Desktop、Claude Code、Cursor、ChatGPT、n8n、VS Code、Google ADK或任何与MCP兼容的工具。看 设置.md.
wiki命令行界面 -相同的API客户端,相同的身份验证,无需人工智能。对于shell管道、CI检查、cron作业。看 CLI.md.- Claude代码插件 —
/plugin marketplace add olgasafonova/mediawiki-mcp-server将wiki技能直接添加到Claude Code中。看 .claude插件/README.md.
文档
| 文档 | 它涵盖了什么 |
|---|---|
| QUICKSTART.md | 2分钟后开始跑步 |
| 设置.md | 按工具配置(克劳德桌面、光标、ChatGPT、n8n、VS代码、谷歌ADK) |
| CLI.md | wiki 命令行参考 |
| TOOLS.md | 完整工具参考(按类别列出43种工具) |
| 部署.md | HTTP传输、安全性、端点、环境变量 |
| TIETO_SETUP.md | 连接到Tieto的公共360°Wiki(适合初学者) |
| WIKI_USE_CASES.md | 按角色划分的详细工作流程 |
| 建筑.md | 系统设计 |
| 贡献.md | 如何做出贡献 |
| 安全.md | 安全策略 |
| 更改日志.md | 版本历史 |
你能做什么?
同样的操作可以从提示符(通过MCP)或直接在shell中(通过 wiki CLI):
| 目标 | 提示您的AI | 从您的终端 |
|---|---|---|
| 搜索wiki | “我们的维基对入职有什么看法?” | wiki search "onboarding" |
| 阅读一页 | “显示入门页面” | wiki page "Getting Started" |
| 查找断开的链接 | “文档页面上是否有断开的链接?” | wiki links broken --json |
| 查找过时内容 | “哪些页面在90天内没有更新?” | wiki stale-pages --days 90 |
| 交叉链接建议 | “哪些页面类似于API参考?” | wiki similar "API Reference" |
| 审核wiki运行状况 | “在wiki上运行健康检查” | wiki audit --json |
| 发布降价 | “将此README发布到wiki” | wiki publish README.md "Page Title" |
| 打一个名字 | “在团队页面上淘汰约翰·史密斯” | wiki replace "Team" --find "John Smith" --replace "<s>John Smith</s>" |
有关完整的工具列表,请参阅 TOOLS.mdCLI返回CI友好分支的键入退出代码——请参阅 CLI.md.
30秒开始
- 获取二进制文件。 下载自 发布 或
go build -o mediawiki-mcp-server .(需要Go 1.24+)。 - 查找您的wiki API URL --通常
https://your-wiki.com/api.php维基百科https://en.wikipedia.org/w/api.php.参观Special:Version以确认。 - 将其连接到您的AI工具 --看 设置.md 对于与您的客户端匹配的配置。
无需登录即可阅读公共wiki。私人/公司维基和编辑需要机器人密码-- SETUP.md#编辑维基页面.
示例提示
📖 更多示例: 看见 WIKI_USE_CASES.md 按角色(内容编辑器、文档管理员、开发人员)查看详细的工作流程。
搜索并阅读:
- “我们的维基对部署有什么看法?”
- “快速浏览配置页面”
- 一次性获取主页、常见问题解答和设置的内容
跟踪更改:
- “本周更新了哪些页面?”
- “显示最后两个版本之间的差异”
- “本月最活跃的编辑是谁?”
检查质量:
- “此页面上是否有断开的链接?”
- “查找没有链接的孤立页面”
- “查找与《安装指南》类似的页面”
- “查找过去90天内未更新的页面”
页面管理 (需要身份验证):
- 将“旧指南”重命名为“更新指南”
- “在团队页面上淘汰约翰·史密斯”
- “在发行说明中将‘版本2.0’替换为‘版本3.0’”
文件上传和搜索 (需要身份验证):
- “将此图像从URL上载到wiki”
- “将此本地文件上载到wiki” (代理base64对字节进行编码;不需要公共URL)
- “在文件中搜索‘预算’:年报.pdf”
转换Markdown:
- “将此README转换为wiki格式”
- “使用Tieto品牌和CSS进行转换” (使用theme=“tieto”,add_css=true)
PDF搜索设置
PDF搜索需要 pdftotext 来自poppler-utils的工具。文本文件搜索(TXT、MD、CSV等)无任何依赖关系。
| 平台 | 安装命令 |
|---|---|
| macOS | brew install poppler |
| Ubuntu/Debian | apt install poppler-utils |
| RHEL/CentOS | yum install poppler-utils |
| 窗户 | choco install poppler |
Windows替代方案: 从下载二进制文件 poppler windows发布 并添加到PATH中。
验证安装:
pdftotext -v
兼容性
| 平台 | 运输 | 状态 |
|---|---|---|
| 克劳德桌面(Mac/Windows) | stdio | ✅ 支持 |
| 克劳德代码CLI | stdio | ✅ 支持 |
| 光标 | stdio | ✅ 支持 |
| VS代码 | stdio | ✅ 支持 |
| ChatGPT | HTTP | ✅ 支持 |
| n8n | HTTP | ✅ 支持 |
| 谷歌ADK | stdio/HTTP | ✅ 支持 |
适用于任何wiki: 维基百科、Fandom、企业维基或任何MediaWiki安装。
故障排除
常见问题和修复程序已上线 SETUP.md#故障排除为了进行更深入的诊断,HTTP服务器公开 /health, /ready,以及 /status 端点--请参见 部署.md.
发展
构建、测试和贡献:请参阅 贡献.md关于系统设计、封装布局和数据流,请参见 建筑.md.
在按下之前运行完整检查:
go test -race -failfast ./...
golangci-lint run ./...
通过以下方式对真实的MediaWiki实例运行集成测试 docker-compose.test.yml。参见 贡献.md 对于工作流程。
喜欢这个项目?
如果此服务器为您节省了时间,请考虑给它一个⭐ 在GitHub上。它帮助其他人发现项目。
更多MCP服务器
查看我的其他MCP服务器:
| 服务器 | 描述 | 星号 |
|---|---|---|
| gleif mcp服务器 | 访问GLEIF LEI数据库。查找公司身份,核实法人实体。 | |
| miro-mcp服务器 | 使用AI控制Miro白板。白板、图表、思维导图等。 | |
| 北欧注册mcp服务器 | 访问北欧商业登记处。查找挪威、丹麦、芬兰、瑞典的公司。 | |
| 产品计划mcp服务器 | 谈谈你的产品计划路线图。查询OKRs、想法、发布。 | |
| 提供strone mcp | 北欧杂货交易狩猎。查找优惠、计划膳食、跟踪支出。 | |
| mcp服务器卡启动 | 前往SEP-2127服务器卡库。MCP服务器的预连接发现。 |
许可证
MIT 许可证
鸣谢
- 内置于 Go MCP SDK
- 由...驱动 MediaWiki API
