Wikipedia Mcp

Wikipedia MCP 服务

该项目提供一个模型上下文协议（MCP）服务，用于以结构化方式访问 Wikipedia 内容。它使用 FastMCP 框架定义工具，可用于 AI 工作流、Agent，或 Claude 和 VS Code 等开发环境。

✅ 功能

• 🔍 搜索 Wikipedia 页面
• 📄 获取页面摘要、完整内容和 HTML
• 🔗 提取链接、图片、参考资料和分类
• 📌 检测消歧选项
• 📌 检查页面是否存在
• ⚡ 基于 FastMCP 构建，可接入任何 Agent 系统

---

🛠 安装（本地）

git clone https://github.com/yourname/wikipedia-mcp-server.git

cd wikipedia-mcp-server

python3 -m venv .venv

source .venv/bin/activate

pip install -r requirements.txt

python wikipedia_mcp_server.py

🛠 安装（Docker）

🐳 Docker 设置

构建容器：

docker build -t wikipedia-mcp .

运行服务：

docker run -it --rm wikipedia-mcp

🛠 使用

🧠 可用工具

工具名称	描述
--------------------	--------------------------------------------------
get_summary	获取 Wikipedia 页面的摘要
get_content	获取 Wikipedia 页面的完整内容
get_html	获取 Wikipedia 页面的渲染后 HTML
get_images	获取 Wikipedia 页面中的图片 URL 列表
get_links	获取 Wikipedia 页面中的内部链接列表
get_references	获取 Wikipedia 页面中的外部参考资料列表
get_categories	获取 Wikipedia 分类列表
get_url	获取 Wikipedia 的直接 URL
get_title	获取 Wikipedia 页面的规范标题
get_page_id	获取 Wikipedia 页面的内部 ID
search_pages	搜索 Wikipedia 页面标题
check_page_exists	检查 Wikipedia 页面是否存在
disambiguation_options	获取含糊标题的消歧选项
--------------------	--------------------------------------------------

📁 文件结构

.
├── wikipedia_mcp_server.py
├── requirements.txt
├── Dockerfile
├── README.md

💻 VS Code / Claude MCP 集成

将以下内容添加到 .vscode/settings.json 或 Claude 配置中，以通过 MCP 启动此服务：

✅ 本地 Python 执行

{
  "mcp": {
    "servers": {
      "wikipedia": {
        "type": "stdio",
        "command": "python3",
        "args": [
          "/absolute/path/to/wikipedia_mcp_server.py"
        ]
      }
    }
  }
}

🐳 Docker 执行

{
  "mcp": {
    "servers": {
      "wikipedia": {
        "type": "stdio",
        "command": "docker",
        "args": [
          "run",
          "--rm",
          "-i",
          "--mount",
          "type=bind,src=${workspaceFolder},dst=/workspace",
          "wikipedia-mcp"
        ]
      }
    }
  }
}