AI导哈

维基百科对话助手

一个基于MCP框架的对话式AI代理，能够通过LangGraph和LangChain搜索维基百科、提取信息并回答问题。

  • by Darkcode100x20
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Darkcode100x20/wikipedia_assistant_mcp

使用说明

维基百科助手

一个通过MCP（模型上下文协议）框架使用维基百科搜索工具的对话式AI代理。该代理能够搜索维基百科、提取信息，并使用LangGraph和LangChain来回答问题。

项目结构

wikipedia_assistant/
├── mcp_server.py          # MCP server with Wikipedia tools (do not modify)
├── mcp_client.py          # Alternative client implementation (do not modify)
├── langgraph_state.py     # LangGraph state definition
├── load_mcp_tools.py      # Graph creation and tool loading
├── run_agent.py           # Main entry point and CLI interface
├── requirements.txt       # Python dependencies
└── README.md             # This file

特点/功能

  • 维基百科搜索搜索并检索维基百科文章
  • **交互式命令行界面（CLI）**用于对话的命令行界面
  • 提示系统支持带参数的结构化提示
  • 工具集成使用MCP协议进行工具发现和执行
  • 状态管理与LangGraph保持持续对话状态

设置

  1. 安装依赖项：

    pip install -r requirements.txt

  2. 设置OpenAI API密钥：

    export OPENAI_API_KEY="your-openai-api-key-here"

使用方法

运行交互式代理：

python3 run_agent.py

可用命令

  • 日常对话输入任何关于维基百科主题的问题
  • 列出提示： /prompts 或者 /list_prompts
  • 执行提示： /prompt <name> "arg1" "arg2" ...
  • 退出: exit， quit，或者 q

示例用法

You: Tell me about Alan Turing
AI: [Searches Wikipedia and provides information about Alan Turing]

You: /prompts
[Lists available prompts from the MCP server]

You: /prompt highlight_sections_prompt "Albert Einstein"
[Executes the prompt with the given argument]

技术细节

建筑学

  • MCP 服务器 (mcp_server.py)：通过MCP协议提供维基百科搜索工具
  • LangGraph 代理 （load_mcp_tools.py): 创建一个集成工具的对话图
  • 状态管理 （langgraph_state.py): 定义消息处理的共享状态
  • 命令行界面（CLI） (run_agent.py): 交互式命令行界面

依赖项

  • langchain-openaiOpenAI大型语言模型（LLM）集成
  • langchain-coreLangChain的核心功能
  • langchain-mcp-adaptersMCP协议适配器
  • langgraph基于图的代理框架
  • mcp模型上下文协议库
  • wikipedia维基百科API封装器

故障排除

  1. 缺少API密钥确保 OPENAI_API_KEY 环境变量已设置
  2. 导入错误安装所有依赖项，使用 pip install -r requirements.txt
  3. 服务器连接确保Python可以执行 mcp_server.py

文件分析

所需文件

  • ✅ langgraph_state.py - 对于状态管理至关重要
  • ✅ load_mcp_tools.py - 图表创建的核心功能
  • ✅（这个符号在中文中通常表示“正确”、“确认”或“完成”的意思，但直接翻译时可能无法完全传达其含义，因此在这里保留原符号并稍作解释） run_agent.py - 主入口
  • ✅ mcp_server.py - 所需的MCP服务器（如要求，保持不变）
  • ✅ requirements.txt - 依赖管理

重复文件/遗留文件

  • ⚠️ mcp_client.py - 包含重复功能和安全问题（按要求保留）

该项目的主要文件已具备功能性 mcp_client.py 看起来这是一个包含重复代码和硬编码API密钥的旧版本，但根据您的要求已保留。

相关 MCP