🌐 Wikipedia MCP Agent

A conversational AI agent that searches and reads Wikipedia using the Model Context Protocol (MCP), LangGraph, and AWS Bedrock (Claude Sonnet).

Python LangGraph MCP AWS Bedrock License

Overview

This project wires together three modern AI infrastructure pieces:

MCP (Model Context Protocol) — a standard way to expose tools, prompts, and resources to an LLM
LangGraph — a graph-based agent framework for multi-step reasoning with tool calls
AWS Bedrock — managed LLM inference using Anthropic's Claude Sonnet

The agent launches an MCP server as a subprocess, dynamically loads its Wikipedia tools at runtime, and runs a stateful chat loop where the LLM can call tools as needed before answering.

Architecture

┌─────────────────────────────────────────────────────┐
│                    mcp_client.py                    │
│                                                     │
│  ┌──────────────────────────────────────────────┐   │
│  │              LangGraph StateGraph            │   │
│  │                                              │   │
│  │   START ──► chat_node ──► tool_node ──┐      │   │
│  │                  ▲                    │      │   │
│  │                  └────────────────────┘      │   │
│  │                         │ END                │   │
│  └─────────────────────────┼────────────────────┘   │
│                            │ tool calls              │
│              stdin/stdout (MCP stdio transport)      │
└────────────────────────────┼────────────────────────┘
                             │
┌────────────────────────────▼────────────────────────┐
│                    mcp_server.py                    │
│                                                     │
│   Tools      search_wikipedia                       │
│              list_wikipedia_sections                │
│              get_section_content                    │
│                                                     │
│   Prompts    highlight_sections_prompt              │
│                                                     │
│   Resources  suggested_titles                       │
└─────────────────────────────────────────────────────┘
                             │
                    wikipedia Python library

Features

Tools

Tool	Description
`search_wikipedia`	Search Wikipedia and return the summary + URL of the top result
`list_wikipedia_sections`	List all section titles of a Wikipedia article
`get_section_content`	Fetch the full text of a specific section

Prompts

Prompt	Description
`highlight_sections_prompt`	Ask the LLM to pick the 3–5 most important sections of an article and explain why

Resources

Resource	Description
`suggested_titles`	Reads a local `suggested_titles.txt` file with topic suggestions

Getting Started

Prerequisites

Python 3.10+
AWS account with Bedrock access enabled for anthropic.claude-sonnet-4-6 in eu-west-2

Installation

# Clone the repo
git clone https://github.com/sadeghetemad/wikipedia-mcp-agent.git
cd wikipedia-mcp-agent

# Create and activate a virtual environment
python -m venv venv
venv\Scripts\activate        # Windows
# source venv/bin/activate   # macOS / Linux

# Install dependencies
pip install -r requirements.txt

AWS Credentials

Configure your credentials via the AWS CLI or environment variables:

aws configure

Or manually:

export AWS_ACCESS_KEY_ID=your_key
export AWS_SECRET_ACCESS_KEY=your_secret
export AWS_DEFAULT_REGION=eu-west-2

Make sure your IAM user/role has the bedrock:InvokeModel permission.

Usage

python mcp_client.py

You will see:

Wikipedia MCP agent is ready.
Type a question or use one of the slash commands below:
  /prompts                       - list available prompt templates
  /prompt <name> "arg1" ...      - run a prompt template
  /resources                     - list available resources
  /resource <name or index>      - view a resource
  exit / quit / q                - quit

Example session

You: What is quantum entanglement?
AI: Quantum entanglement is a physical phenomenon where two or more particles ...

You: /prompts
Available Prompts:
  highlight_sections_prompt  (topic)

You: /prompt highlight_sections_prompt "Black hole"
=== Prompt Result ===
• Formation — explains how black holes arise from stellar collapse
• Event horizon — the defining boundary of no return
...

You: /resources
Available Resources:
[1] suggested_titles

You: /resource 1
=== Resource Text ===
Artificial intelligence
Large language model
...

Optional: `suggested_titles.txt`

Create this file in the project root (one topic per line) to populate the suggested_titles resource:

Artificial intelligence
Large language model
Model Context Protocol
Quantum computing

Project Structure

wikipedia-mcp-agent/
├── mcp_server.py          # FastMCP server — tools, prompts, resources
├── mcp_client.py          # LangGraph agent + interactive chat loop
├── requirements.txt       # Pinned Python dependencies
├── suggested_titles.txt   # (optional) topic suggestions for the resource
└── README.md

Tech Stack

Layer	Library
LLM	AWS Bedrock via `langchain-aws`
Agent framework	LangGraph
Tool protocol	MCP via `mcp` + `langchain-mcp-adapters`
Wikipedia data	`wikipedia`

License

MIT