Update README.md

README.md

@@ -1,5 +1,5 @@
 ---
-title: Hieroglyph Mcp Server
+title: Rosetta Decoder
 emoji: 👁
 colorFrom: gray
 colorTo: yellow
@@ -7,52 +7,78 @@ sdk: gradio
 sdk_version: 6.0.1
 app_file: app.py
 pinned: false
-short_description: Detect and classify hieroglyphs to its Gardiner code
+short_description: Detect & Translate hieroglyphics
 tags:
   - building-mcp-track-creative
+  - building-mcp-track-consumer
+  - mcp-in-action-track-creative
+  - mcp-in-action-track-consumer
   - mcp-server
 ---
 
 
 # 𓀀 Egyptian Hieroglyph Detector (MCP Server)
 
-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 Ai Agents 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 Hieroglyphs in any image.
 
 ## 👥 Team
 
-- **[youkii-xr](https://huggingface.co/youkii-xr)** – XR Developer, did the MCP and Gradio part <br> [![LinkedIn](https://img.shields.io/badge/LinkedIn-0077B5?style=flat&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/youkii-xr/)
-- **[mariam-essam](https://huggingface.co/mariam-essam)** – AI Engineer, did the AI model part  <br> [![LinkedIn](https://img.shields.io/badge/LinkedIn-0077B5?style=flat&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/mariam-essam-ai-engineer/)
+- **[youkii-xr](https://huggingface.co/youkii-xr)** –  XR Developer, did the MCP and Gradio part<br> [![LinkedIn](https://img.shields.io/badge/LinkedIn-0077B5?style=flat&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/youkii-xr/)
+- **[MariamEssam204](https://huggingface.co/MariamEssam204)** – AI Engineer, did the AI model part <br> [![LinkedIn](https://img.shields.io/badge/LinkedIn-0077B5?style=flat&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/mariam-essam-ai-engineer/)
 
 ## 🎥 Demo Video
 
-| Claude Desktop MCP Server | Hieroglyphic Gradio Web App |
-| :---: | :---: |
-| [![Claude Desktop Demo](https://img.youtube.com/vi/Vvlu6sDzsBE/hqdefault.jpg)](https://youtu.be/Vvlu6sDzsBE) | [![Gradio App Demo](https://img.youtube.com/vi/GSXIpSummOU/hqdefault.jpg)](https://youtu.be/GSXIpSummOU) |
-
-## 🚨🌍 IMPORTANT NOTICE FOR HACKATHON 🤖
+| Gradio App V2 | Mobile Camera Test | MCP Server |
+| :---: | :---: | :---: |
+| [![Gradio App V2](https://img.youtube.com/vi/nnQnNfJtSWM/hqdefault.jpg)](https://youtu.be/nnQnNfJtSWM) | [![Mobile Camera Test](https://img.youtube.com/vi/wZKBVYAZwZ4/hqdefault.jpg)](https://youtu.be/wZKBVYAZwZ4) | [![MCP Server](https://img.youtube.com/vi/Vvlu6sDzsBE/hqdefault.jpg)](https://youtu.be/Vvlu6sDzsBE) |
 
-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:**  
-[[Gradio App](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)]<br>
-[[MCP Server](https://www.linkedin.com/posts/youkii-xr_huggingface-mcp-ai-activity-7400474001891819520-tTa3?utm_source=social_share_send&utm_medium=member_desktop_web&rcm=ACoAADSn0yMBo1MdVldbeoL5OxUZo2-CMJKUKOM)]
+[[Gradio App - V2](https://www.linkedin.com/posts/youkii-xr_our-hieroglyphic-ai-detector-just-got-a-major-activity-7400855950632411136-5Z9Y?utm_source=social_share_send&utm_medium=member_desktop_web&rcm=ACoAADSn0yMBo1MdVldbeoL5OxUZo2-CMJKUKOM)]<br>
+[[Mobile camera test](https://www.linkedin.com/posts/mariam-essam-ai-engineer_productdevelopment-dataaugmentation-realtimeai-activity-7400635609570205696-a9JN?utm_source=social_share_send&utm_medium=member_desktop_web&rcm=ACoAADSn0yMBo1MdVldbeoL5OxUZo2-CMJKUKOM)]<br>
+[[Gradio App - V1](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)]<br>
+[[MCP Server - V1](https://www.linkedin.com/posts/youkii-xr_huggingface-mcp-ai-activity-7400474001891819520-tTa3?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:
+#### Hieroglyphs Detection:
+* trained on 400+ different glyphs
+* able to detect with high confidence
+
+#### Translation
+* **Mystical prophecy** : translates for tourists and non-academics as a story
+* **Academic Translation** : a linguistics breakdown of symbols and their meaning and how they fit together
+
+#### Analytics
+* **Spatial Heatmaps** : visualizes where glyphs are clustered on the wall / papyrus
+* **Confidence Charts** : Shows how sure the AI is about every symbol
+* **Frequency Analysis** : Counts the occurrence of distinguished symbols
+
+#### Digital Encyclopedia
+* Includes a searchable database of supported Gardiner Codes with descriptions and transliteration
+
+#### Downloadable Results
+* Download the detection result with bounding boxes surrounding each glyph on the wall / papyrus
+* Download glyphs gallery as a zip containing all glyphs detected individually cropped
+
+## 🔌Available MCP Tools
+When connected to Claude Desktop, this server exposes **4 specific tools** that allow the Agent to perform the full archaeological pipeline:
 
-### 1. `detect_hieroglyphs` (The AI Eye)
+#### `detect glyphs`
+* **Description:** Scans an input image to find hieroglyphs.
+* **Returns:** A path to the annotated image (boxes drawn) and a JSON object containing the list of found codes and confidence scores.
 
-- **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.
+#### `translate story`
+* **Description:** Takes a list of Gardiner codes or keywords and interprets them.
+* **Returns:** Two distinct texts: a "Mystical Story" (creative interpretation) and an "Academic Translation" (scientific interpretation).
 
-### 2. `upload_file` (The Bridge)
+#### `get stats`
+* **Description:** Takes the detection data and generates visual reports.
+* **Returns:** A path to an image file containing charts for Symbol Frequency, Confidence Levels, and Spatial Heatmaps.
 
-- **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.
+#### `list codes`
+* **Description:** Provides access to the full internal database of Egyptian hieroglyphs.
+* **Returns:** The complete dictionary of supported Gardiner codes, descriptions, and categories.
 
 ## 🚀 How to Use (Claude Desktop)
 
@@ -71,23 +97,23 @@ Add this to your `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/L
 ```
 {
   "mcpServers": {
-    "hieroglyph-ai": {
-      "command": "npx.cmd",
+    "gradio": {
+      "command": "npx",
       "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/)",
+        "https://mcp-1st-birthday-rosetta-decoder.hf.space/gradio_api/mcp/",
         "--transport",
         "streamable-http"
       ]
     },
     "upload_helper": {
-      "command": "python",
+      "command": "C:\\Python313\\python.exe",
       "args": [
         "-m",
         "gradio",
         "upload-mcp",
-        "[https://youkii-xr-hieroglyph-mcp-server.hf.space/](https://youkii-xr-hieroglyph-mcp-server.hf.space/)",
-        "C:\\Claude_Work" 
+        "https://mcp-1st-birthday-rosetta-decoder.hf.space/",
+        "C:\\Claude_Work"
       ]
     }
   }
@@ -98,7 +124,7 @@ Add this to your `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/L
 
 ## 🧩 Technical Architecture
 
-- **Framework:**  Gradio 5.9.0 (with native MCP support)
+- **Framework:**  Gradio 6.0.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)