Update README.md

README.md

@@ -16,82 +16,87 @@ tags:
 
 # 𓀀 Egyptian Hieroglyph Detector (MCP Server)
 
-Welcome to our submission for the MCP Hackathon (Track 1: Building MCP)!
+Welcome to our submission for the ​**MCP Hackathon (Track 1: Building MCP)** !
 
-This project bridges the gap between ancient history and modern AI Agents.  
-It provides an MCP Server that allows Claude Desktop to "see" and identify Gardiner's Egyptian Hieroglyphs in any image.
-
----
+This project bridges the gap between ancient history and modern AI Agents. It provides an **MCP Server** that allows Ai Agents to "see" and identify Gardiner's Egyptian Hieroglyphs in any image.
 
 ## 🎥 Demo Video
 
-(Replace **YOUR_VIDEO_ID** in the link above with your actual YouTube video ID)
-
----
-
+(https://www.linkedin.com/posts/mariam-essam-ai-engineer_machinelearning-computervision-ai-activity-7400193629241143296-sWvC?utm_source=social_share_send&utm_medium=member_desktop_web&rcm=ACoAADSn0yMBo1MdVldbeoL5OxUZo2-CMJKUKOM)
 ## 🚨🌍 IMPORTANT NOTICE FOR HACKATHON 🤖
 
-We are participating in the Creative Track (**building-mcp-track-creative**) because this tool unlocks new cultural and educational capabilities for AI agents.
-
-**🔗 Social Media Post:**  
-[Link to your X/LinkedIn Post Here]
-
----
-
-## 🌐 Project Overview
-
-This is not just a standard object detector.  
-It is a **Hybrid Security Architecture** designed for the Model Context Protocol:
-
-### **🔓 Public Interface**
-An open MCP endpoint hosted on Hugging Face Spaces that anyone can connect to.
-
-### **🔐 Private Intelligence**
-The core intelligence (a fine-tuned YOLOv8 model) is hosted in a **Private Repository**.  
-The Space acts as a secure proxy, authenticating with a secret token to load the weights without exposing them to the public.
+We are participating in the **Creative Track** (`building-mcp-track-creative`) because this tool unlocks new cultural and educational capabilities for AI agents.
 
-### **🛡️ Secure Bridge**
-We built a custom **Upload Helper** tool that allows Claude Desktop to securely transfer local files from your computer to the cloud server for analysis.
-
----
+🔗 **Social Media Post:**  
+[[Link to your X/LinkedIn Post Here](https://www.linkedin.com/posts/mariam-essam-ai-engineer_machinelearning-computervision-ai-activity-7400193629241143296-sWvC?utm_source=social_share_send&utm_medium=member_desktop_web&rcm=ACoAADSn0yMBo1MdVldbeoL5OxUZo2-CMJKUKOM)]
 
 ## 🗂️ Capabilities & Tools
 
-When connected to Claude, this server exposes **two powerful tools**:
-
-### **1. `detect_hieroglyphs` (The AI Eye)**
+When connected to Claude, this server exposes two powerful tools:
 
-- **Purpose:** Takes an image input and performs object detection for Egyptian Hieroglyphs.  
-- **Output:** Annotated image + JSON summary of symbol counts (e.g., `"3x Owl"`, `"1x Water"`).  
-- **Model:** Custom-trained YOLOv8 model specialized on Gardiner signs.
+### 1. `detect_hieroglyphs` (The AI Eye)
 
----
-
-### **2. `upload_file` (The Bridge)**
+- **Purpose:**  Takes an image input and performs object detection for Egyptian Hieroglyphs.
+- **Output:**  Returns an annotated image with bounding boxes drawn around symbols, plus a JSON summary of symbol counts (e.g., "3x Owl", "1x Water").
+- **Model:**  Powered by a custom-trained YOLOv8 model specialized on the Gardiner Sign List.
 
-- **Purpose:** Solves the “local vs. cloud” problem.  
-- **Function:** Uploads a local file from your machine to the Space’s temporary storage so the AI can analyze it.
+### 2. `upload_file` (The Bridge)
 
----
+- **Purpose:**  Solves the "Local vs. Cloud" problem. Since the server runs in the cloud, it cannot see your `C:` drive.
+- **Function:**  Claude uses this tool to upload a specific local image to the secure temporary storage of the Space, returning a valid URL for the AI Eye to process.
 
 ## 🚀 How to Use (Claude Desktop)
 
 You can connect this tool to your own Claude Desktop right now!
 
-### **📌 Prerequisites**
-
-- Claude Desktop installed  
-- Node.js & Python  
-- Gradio MCP extension:  
-  ```sh
-  pip install "gradio[mcp]"
-
-### ⚙️ Configuration
-
-Add the following JSON to your Claude Desktop configuration file.
-
-Windows path: %APPDATA%\Claude\claude_desktop_config.json
-
-Mac path: ~/Library/Application Support/Claude/claude_desktop_config.json
-
-Replace C:\\Claude_Work with the actual folder where you keep images, and update the URLs if your Space address differs.
+### Prerequisites
+
+- **Claude Desktop** installed.
+- **Node.js** & **Python** installed.
+- **Gradio MCP:**  Run `pip install "gradio[mcp]"`​
+
+### Configuration
+
+Add this to your `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac):
+
+```
+{
+  "mcpServers": {
+    "hieroglyph-ai": {
+      "command": "npx.cmd",
+      "args": [
+        "mcp-remote",
+        "[https://youkii-xr-hieroglyph-mcp-server.hf.space/gradio_api/mcp/](https://youkii-xr-hieroglyph-mcp-server.hf.space/gradio_api/mcp/)",
+        "--transport",
+        "streamable-http"
+      ]
+    },
+    "upload_helper": {
+      "command": "python",
+      "args": [
+        "-m",
+        "gradio",
+        "upload-mcp",
+        "[https://youkii-xr-hieroglyph-mcp-server.hf.space/](https://youkii-xr-hieroglyph-mcp-server.hf.space/)",
+        "C:\\Claude_Work" 
+      ]
+    }
+  }
+}
+```
+
+ *(Note: Change* *​`C:\\Claude_Work`​*​ *to the actual folder where you keep your images)*
+
+## 🧩 Technical Architecture
+
+- **Framework:**  Gradio 5.9.0 (with native MCP support)
+- **Model:**  Ultralytics YOLOv8 (Private Weights)
+- **Storage:**  Hugging Face Hub (Private Repo for Model, Public Space for Inference)
+- **Protocol:**  Model Context Protocol (MCP) via SSE (Server-Sent Events)
+
+## 👥 Team
+
+- **[youkii-xr]**  – Ai Engineer, did the Ai model part
+- **[mariam-essam]**  – XR Developer, did the MCP and gradio part
+
+*Built with ❤️ for the Hugging Face MCP Hackathon 2025*