Update README.md

README.md

@@ -1,14 +1,79 @@
 ---
-title: Wikipedia Entity Extractor MCP Server
-emoji: 🌖
-colorFrom: green
-colorTo: pink
+title: Wikipedia Entity Extractor — MCP Server
+emoji: 👀
+colorFrom: pink
+colorTo: red
 sdk: gradio
 sdk_version: 5.33.0
 app_file: app.py
 pinned: false
 license: mit
-short_description: 🧠 Wikipedia Entity Extractor — MCP Server
+short_description: entity-recognizer
+tags:
+- mcp-server-track
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 🧠 Wikipedia Entity Extractor — MCP Server
+
+Welcome to the **Wikipedia Entity Extractor**, a simple yet powerful MCP-compatible tool built with 🤗 Gradio and 🔗 Hugging Face Inference API. This project was created as part of the Gradio Hackathon to showcase how **modular AI components** can be wired together using the **Model Context Protocol (MCP)**.
+
+## ✨ What It Does
+
+- Takes **freeform user text** as input.
+- Uses a **Hugging Face-hosted LLM** (like Qwen or Mixtral) to extract **named entities** likely to have a Wikipedia page.
+- Searches **Wikipedia** for those entities.
+- Returns a clean, structured **JSON dictionary** mapping each entity to the first paragraph of its Wikipedia article.
+
+> “Who is Alan Turing and what is Bletchley Park?” → 🧠 → 📚 → ✅ JSON with article intros
+
+## 🚀 Tech Stack
+
+- `Gradio` — UI and MCP server integration
+- `huggingface_hub.InferenceClient` — for efficient, plug-and-play LLM calls
+- `requests` — to fetch article summaries from Wikipedia’s REST API
+- `MCP` — to allow this component to be chained with others seamlessly
+
+## 🔐 Secure Token Handling
+
+This app uses a **bring-your-own-token** approach:
+- The Hugging Face token is passed as a user input (masked password field).
+- No secrets are exposed in the public Space.
+- You can also set `HF_TOKEN` via environment variables for internal runs.
+
+## 🧰 Example Input
+
+```text
+Barack Obama was born in Hawaii and studied at Harvard Law School.
+```
+## 📦 Example Output
+
+```json
+{
+"Barack Obama":
+  "Barack Hussein Obama II is an American politician who was the 44th president of the United States from 2009 to 2017. A member of the Democratic Party, he was the first African American president in American history. Obama previously served as a U.S. senator representing Illinois from 2005 to 2008 and as an Illinois state senator from 1997 to 2004.",
+"Hawaii":
+  "Hawaii is an island state of the United States, in the Pacific Ocean about 2,000 miles (3,200 km) southwest of the U.S. mainland. One of the two non-contiguous U.S. states, it is the only state not on the North American mainland, the only state that is an archipelago, and the only state in the tropics.",
+"Harvard Law School":
+  "Harvard Law School (HLS) is the law school of Harvard University, a private research university in Cambridge, Massachusetts. Founded in 1817, Harvard Law School is the oldest law school in continuous operation in the United States."
+}
+```
+
+## 🛠 How to Run
+
+You can run this:
+
+set HF_TOKEN in your env 
+Locally with python app.py
+or
+In a Hugging Face Space
+
+
+## 🤝 Designed For
+
+AI agents that need grounding via structured world knowledge
+
+Tool-augmented chatbots
+
+Zero-shot extract-and-retrieve pipelines
+
+Hackathon creativity 🤖🧩🚀