Add DEPLOYMENT.md with publishing instructions, update server.json to version 0.4.7, and enhance README with MCP Registry guidance.

Author: rodion-m

.gitignore

@@ -181,3 +181,6 @@ cython_debug/
 
 # MCP configuration file
 .mcp.json
+
+# MCP Registry token files
+.mcpregistry_*

DEPLOYMENT.md

@@ -0,0 +1,113 @@
+# Deployment Guide
+
+This guide covers publishing CodeAlive MCP to the MCP Registry.
+
+## Prerequisites
+
+### Install mcp-publisher
+
+Build from source (documented install methods like `brew install` and `install.sh` are not available):
+
+```bash
+git clone https://github.com/modelcontextprotocol/registry.git
+cd registry
+make publisher
+```
+
+The binary will be at `./bin/mcp-publisher`.
+
+### GitHub org membership (for org repos)
+
+Your organization membership must be public:
+1. Go to https://github.com/orgs/CodeAlive-AI/people
+2. Find your username and set visibility to "Public"
+
+## Publishing to MCP Registry
+
+### 1. Login with GitHub
+
+```bash
+./bin/mcp-publisher login github
+```
+
+Follow the device authorization flow:
+1. Go to the URL shown (e.g., https://github.com/login/device)
+2. Enter the code displayed
+3. Authorize the application
+
+### 2. Update server.json
+
+Before publishing, update `server.json`:
+
+1. **Bump the version** field to match your release
+2. **Use the latest schema** (currently `2025-12-11`)
+3. **Update package identifier** with new version tag
+
+Example `server.json` structure:
+```json
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.CodeAlive-AI/codealive-mcp",
+  "version": "0.4.7",
+  ...
+  "packages": [
+    {
+      "registryType": "oci",
+      "identifier": "ghcr.io/codealive-ai/codealive-mcp:0.4.7",
+      "runtimeHint": "docker",
+      ...
+    }
+  ]
+}
+```
+
+**Important notes:**
+- OCI packages must NOT have a separate `version` field inside the package object - the version is embedded in the `identifier` tag
+- Schema version must be current (check [changelog](https://github.com/modelcontextprotocol/registry/blob/main/docs/reference/server-json/CHANGELOG.md))
+
+### 3. Publish
+
+```bash
+cd /path/to/codealive-mcp
+/path/to/registry/bin/mcp-publisher publish
+```
+
+On success:
+```
+Publishing to https://registry.modelcontextprotocol.io...
+✓ Successfully published
+✓ Server io.github.CodeAlive-AI/codealive-mcp version 0.4.7
+```
+
+## Troubleshooting
+
+### "not authenticated"
+Re-run login:
+```bash
+./bin/mcp-publisher login github
+```
+
+### "403: your GitHub account doesn't have permission"
+Make your organization membership public:
+1. Go to https://github.com/orgs/CodeAlive-AI/people
+2. Find your username
+3. Change visibility to "Public"
+4. Re-login and try again
+
+### "deprecated schema detected"
+Update `$schema` in `server.json` to the current version. Check the [migration checklist](https://github.com/modelcontextprotocol/registry/blob/main/docs/reference/server-json/CHANGELOG.md#migration-checklist-for-publishers).
+
+### "OCI packages must not have 'version' field"
+Remove the `version` field from inside the `packages` array. The version should only appear in the `identifier` tag (e.g., `ghcr.io/codealive-ai/codealive-mcp:0.4.7`).
+
+## Version Guidelines
+
+- **Patch** (0.4.6 → 0.4.7): Bug fixes, minor improvements
+- **Minor** (0.4.0 → 0.5.0): New features, enhancements
+- **Major** (0.x.x → 1.0.0): Breaking changes, major releases
+
+## Related Resources
+
+- [MCP Registry](https://registry.modelcontextprotocol.io/)
+- [server.json Schema Changelog](https://github.com/modelcontextprotocol/registry/blob/main/docs/reference/server-json/CHANGELOG.md)
+- [MCP Registry GitHub](https://github.com/modelcontextprotocol/registry)

README.md

@@ -47,6 +47,7 @@ After setup, try these commands with your AI assistant:
 *   [Available Tools](#-available-tools)
 *   [Usage Examples](#-usage-examples)
 *   [Troubleshooting](#-troubleshooting)
+*   [Publishing to MCP Registry](#-publishing-to-mcp-registry)
 *   [License](#-license)
 
 ## 🚀 Quick Start (Remote)
@@ -1004,6 +1005,12 @@ Replace `your-server:8000` with your actual deployment URL and port.
 
 ---
 
+## 📦 Publishing to MCP Registry
+
+For maintainers: see [DEPLOYMENT.md](DEPLOYMENT.md) for instructions on publishing new versions to the MCP Registry.
+
+---
+
 ## 📄 License
 
 MIT License - see [LICENSE](LICENSE) file for details.

server.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.CodeAlive-AI/codealive-mcp",
   "version": "0.4.7",
   "description": "Semantic code search and analysis from CodeAlive for AI assistants and agents.",
@@ -33,8 +33,7 @@
   "packages": [
     {
       "registryType": "oci",
-      "identifier": "ghcr.io/codealive-ai/codealive-mcp:0.4.6",
-      "version": "0.4.6",
+      "identifier": "ghcr.io/codealive-ai/codealive-mcp:0.4.7",
       "runtimeHint": "docker",
       "transport": {
         "type": "stdio"