JinDaGe - wikipedia-mcp-server MCP Details

article

README

🚀 维基百科 MCP 服务器

这是一个用于与维基百科 API 交互的 Model Context Protocol (MCP) 服务器，借助它，AI 助手能够便捷地访问维基百科内容，实现文章搜索、历史事件获取以及图像检索等功能。

🚀 快速开始

此服务器提供了通过 Model Context Protocol 与维基百科 API 交互的工具。它允许 AI 助手访问维基百科内容、搜索文章、获取历史事件和检索图像。

✨ 主要特性

该服务器提供的功能丰富多样，具体如下：

onThisDay：获取特定日期发生的历史事件
findPage：根据查询搜索匹配的维基百科页面
getPage：通过标题获取维基百科页面内容
getImagesForPage：通过标题获取维基百科页面中的图像

📦 安装指南

常规安装

npm install @shelm/wikipedia-mcp-server

开发时安装

git clone https://github.com/scotthelm/wikipedia-mcp-server.git
cd wikipedia-mcp-server
npm install
npm run build

💻 使用示例

运行服务器

npx @shelm/wikipedia-mcp-server

这将启动 MCP 服务器，通过 stdio 进行通信。

程序化使用

你也可以在自己的项目中直接使用该包：

import {
  WikipediaServer,
  isValidOnThisDayArgs,
  isValidFindPageArgs,
  isValidGetPageArgs,
  isValidGetImagesForPageArgs,
} from "@shelm/wikipedia-mcp-server";

// 创建一个新的服务器实例
const server = new WikipediaServer();

// 运行服务器
server.run().catch(console.error);

// 或直接使用验证函数和处理程序
if (isValidOnThisDayArgs({ date: "2023-01-01" })) {
  const result = await server.handleOnThisDay({ date: "2023-01-01" });
  console.log(result);
}

示例客户端

提供一个示例客户端来演示如何与服务器交互：

node example-client.js

这将执行以下步骤：

启动服务器
查询可用工具
演示每个工具的样本查询
在简单的网络界面 http://localhost:3000 显示结果

📚 详细文档

开发

构建

npm run build

开发模式运行

npm run dev

测试

通过手动使用示例客户端进行测试：

node example-client.js

这将演示所有可用工具及其样本查询。

MCP 服务器配置

要与 Claude 或其他兼容的助手一起使用此服务器，请将其添加到你的 MCP 配置中：

{
  "mcpServers": {
    "wikipedia": {
      "command": "npx",
      "args": ["@shelm/wikipedia-mcp-server"],
      "env": {}
    }
  }
}

📄 许可证

本项目采用 MIT 许可证。

致谢

如果没有 folks 创建的伟大作品 wikipedia package，这一切都不会实现。

wikipedia-mcp-server