MediaWiki MCP adapter

MediaWikiAdapter

习俗 模型上下文协议（MCP） 用于与MediaWiki和WikiBase API交互的适配器。此适配器允许您使用MCP框架以编程方式获取和编辑MediaWiki页面。

特性

• 获取MediaWiki页面的内容。
• 使用新内容和可选摘要编辑MediaWiki页面。
• 不同MediaWiki和WikiBase实例的可配置API基础URL。

需求

• Node.js（v16或更高版本）
• TypeScript（用于开发）
• 启用API访问的MediaWiki实例

安装

1. 克隆存储库：

   git clone https://github.com/yourusername/mediawikiadapter.git
   cd mediawikiadapter

1. 安装依赖项：

   npm install

1. 构建项目：

   npm run build

用法

配置适配器

您可以将适配器配置为使用自定义MediaWiki和WikiBase API端点：

server.configure({
  mediaWikiAPIBase: "https://my.mediawiki.instance/api.php",
  wikiBaseAPIBase: "https://my.wikibase.instance/api.php",
});

启动MCP服务器

使用以下命令运行MCP服务器：

node build/index.js

资源

getPage内容

获取MediaWiki页面的内容。

• 输入架构:

  {
    "title": "string"
  }

• 输出模式:

  {
    "content": "string"
  }

示例用法：

const response = await server.callResource("getPageContent", {
  title: "Main Page",
});
console.log(response.content);

______________________________________________________________________

工具

编辑页面

用新内容编辑MediaWiki页面。

• 输入架构:

  {
    "title": "string",
    "content": "string",
    "summary": "string (optional)"
  }

• 输出模式:

  {
    "success": "boolean"
  }

示例用法：

const response = await server.callTool("editPage", {
  title: "Main Page",
  content: "Updated content for the page.",
  summary: "Updated via MediaWikiAdapter",
});
console.log(response.success ? "Edit successful" : "Edit failed");

______________________________________________________________________

发展

以开发模式运行

要使用TypeScript在开发模式下运行项目：

npm run dev

代码检查

运行linter检查代码质量：

npm run lint

测试

目前，尚未实施任何测试。您可以将测试添加到 test 目录并使用以下命令运行它们：

npm test

______________________________________________________________________

配置

适配器使用以下默认API基URL：

• MediaWiki API库: https://en.wikipedia.org/w/api.php
• 维基库API库：https://www.wikidata.org/w/api.php

您可以使用以下命令覆盖这些默认值 server.configure() 方法。

______________________________________________________________________

贡献

欢迎投稿！请按照以下步骤操作：

1. 分叉存储库。
2. 为您的功能或错误修复创建一个新分支。
3. 提交一个拉取请求，详细描述您的更改。

______________________________________________________________________

许可证

该项目根据 LGPL-3.0或更高版本 许可证。请参阅 许可证 文件以获取详细信息。

______________________________________________________________________

作者

由...创建 卢卡·莫里.