Merge pull request #211 from Stavitsky/feat/149-add-annotations

feat: add namespace annotations editing UI and backend support

Author: zhjch05

README.md

@@ -1,4 +1,4 @@
-# 🚀 MetaMCP (MCP Aggregator, Orchestrator, Middleware, Gateway in one docker)
+# 🚀 MetaMCP (MCP Aggregator, Orchestrator, Middleware, Gateway in one docker) <!-- omit in toc -->
 
 <div align="center">
 
@@ -31,16 +31,17 @@
 For more details, consider visiting our documentation site: https://docs.metamcp.com
 
 English | [中文](./README_cn.md)
-
-## 📋 Table of Contents
+## 📋 Table of Contents <!-- omit in toc -->
 
 - [🎯 Use Cases](#-use-cases)
 - [📖 Concepts](#-concepts)
-  - [🖥️ MCP Server](#️-mcp-server)
-  - [🏷️ MetaMCP Namespace](#️-metamcp-namespace)
-  - [🌐 MetaMCP Endpoint](#-metamcp-endpoint)
-  - [⚙️ Middleware](#️-middleware)
-  - [🔍 Inspector](#-inspector)
+  - [🖥️ **MCP Server**](#️-mcp-server)
+    - [🔐 **Environment Variables \& Secrets (STDIO MCP Servers)**](#-environment-variables--secrets-stdio-mcp-servers)
+  - [🏷️ **MetaMCP Namespace**](#️-metamcp-namespace)
+  - [🌐 **MetaMCP Endpoint**](#-metamcp-endpoint)
+  - [⚙️ **Middleware**](#️-middleware)
+  - [🔍 **Inspector**](#-inspector)
+  - [✏️ **Tool Overrides \& Annotations**](#️-tool-overrides--annotations)
 - [🚀 Quick Start](#-quick-start)
   - [🐳 Run with Docker Compose (Recommended)](#-run-with-docker-compose-recommended)
   - [📦 Build development environment with Dev Containers (VSCode/Cursor)](#-build-development-environment-with-dev-containers-vscodecursor)
@@ -53,10 +54,14 @@ English | [中文](./README_cn.md)
 - [❄️ Cold Start Problem and Custom Dockerfile](#️-cold-start-problem-and-custom-dockerfile)
 - [🔐 Authentication](#-authentication)
 - [🔗 OpenID Connect (OIDC) Provider Support](#-openid-connect-oidc-provider-support)
-  - [🛠️ Configuration](#️-configuration)
-  - [🏢 Supported Providers](#-supported-providers)
-  - [🔒 Security Features](#-security-features)
-  - [📱 Usage](#-usage)
+  - [🛠️ **Configuration**](#️-configuration)
+  - [🏢 **Supported Providers**](#-supported-providers)
+  - [🔒 **Security Features**](#-security-features)
+  - [📱 **Usage**](#-usage)
+- [⚙️ Registration Controls](#️-registration-controls)
+  - [🎛️ **Available Controls**](#️-available-controls)
+  - [🏢 **Enterprise Use Cases**](#-enterprise-use-cases)
+  - [🛠️ **Configuration**](#️-configuration-1)
 - [🌐 Custom Deployment and SSE conf for Nginx](#-custom-deployment-and-sse-conf-for-nginx)
 - [🏗️ Architecture](#️-architecture)
   - [📊 Sequence Diagram](#-sequence-diagram)
@@ -66,7 +71,6 @@ English | [中文](./README_cn.md)
 - [📄 License](#-license)
 - [🙏 Credits](#-credits)
 
-
 ## 🎯 Use Cases
 - 🏷️ **Group MCP servers into namespaces, host them as meta-MCPs, and assign public endpoints** (SSE or Streamable HTTP), with auth. One-click to switch a namespace for an endpoint.
 -  🎯 **Pick tools you only need when remixing MCP servers.** Apply other **pluggable middleware** around observability, security, etc. (coming soon)
@@ -118,6 +122,7 @@ DATABASE_URL=${DB_CONNECTION_STRING}
 - Group one or more MCP servers into a namespace
 - Enable/disable MCP servers or at tool level
 - Apply middlewares to MCP requests and responses
+- Override tool names/titles/descriptions per namespace and attach custom MCP annotations (e.g. `{ "annotations": { "readOnlyHint": false } }`)
 
 ### 🌐 **MetaMCP Endpoint**
 - Create endpoints and assign namespace to endpoints
@@ -133,6 +138,12 @@ DATABASE_URL=${DB_CONNECTION_STRING}
 ### 🔍 **Inspector**
 Similar to the official MCP inspector, but with **saved server configs** - MetaMCP automatically creates configurations so you can debug MetaMCP endpoints immediately.
 
+### ✏️ **Tool Overrides & Annotations**
+- Open a namespace → **Tools** tab to see every tool coming from connected MCP servers.
+- Each saved tool can be expanded and edited inline: update the display **name/title/description** or provide a JSON blob with namespace-specific annotations (for example `{ "annotations": { "readOnlyHint": false } }`).
+- Badges in the table ("Overridden", "Annotations") show which tools currently have custom metadata. Hover them to read a tooltip describing what was overridden.
+- Annotation overrides are merged with whatever the upstream MCP server returns, so you can safely add custom UI hints without losing provider metadata.
+
 ## 🚀 Quick Start
 
 ### **🐳 Run with Docker Compose (Recommended)**

apps/backend/drizzle/0011_goofy_photon.sql

@@ -0,0 +1,2 @@
+ALTER TABLE "namespace_tool_mappings"
+  ADD COLUMN IF NOT EXISTS "override_annotations" jsonb DEFAULT NULL;