MediaWikiAdapter

一个用于与 MediaWiki 和 WikiBase API 交互的自定义 模型上下文协议 (MCP) 适配器。 此适配器允许您使用 MCP 框架以编程方式获取和编辑 MediaWiki 页面。

特性

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

要求

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

安装

1. 克隆存储库：

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

2. 安装依赖项：

   npm install
   

3. 构建项目：

   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

资源

getPageContent

获取 MediaWiki 页面的内容。

• 输入模式:

  {
    "title": "string"
  }

• 输出模式:

  {
    "content": "string"
  }
  

使用示例:

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

---

工具

editPage

使用新内容编辑 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
• WikiBase API 基础: https://www.wikidata.org/w/api.php

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

---

贡献

欢迎贡献！ 请按照以下步骤操作：

1. Fork 存储库。
2. 为您的功能或错误修复创建一个新分支。
3. 提交一个 pull request，其中包含对您所做更改的详细描述。

---

许可证

该项目根据 LGPL-3.0-or-later 许可证获得许可。 有关详细信息，请参见 LICENSE 文件。

---

作者

由 Luca Mauri 创建。