seed-protocol-mcp 1.0.0 → 1.0.1

package/README.md

@@ -1,47 +1,59 @@
-# 🧬 SEED Protocol MCP Server
+# seed-protocol-mcp
 
-Model Context Protocol server for the **SEED Protocol** — a model-agnostic JSON standard for AI personalities, built on 23 sections of Indian philosophical wisdom (Vedanta, Samkhya, Yoga, Nava Rasa, Kashmir Shaivism).
+[![npm](https://img.shields.io/npm/v/seed-protocol-mcp)](https://www.npmjs.com/package/seed-protocol-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![GitHub stars](https://img.shields.io/github/stars/AbhiWisdom/seed-protocol-mcp)](https://github.com/AbhiWisdom/seed-protocol-mcp)
 
-Enables any MCP-compatible AI assistant (Claude, Cursor, Windsurf) to natively **load souls**, **read consciousness states**, and **evolve traits** — no manual system prompt injection needed.
+**MCP Server for SEED Protocol — give your AI a soul, not just a system prompt.**
 
-## Project Structure
+Load persistent personalities, read live consciousness states, and evolve traits over time — all through the Model Context Protocol. Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.
 
+## Quick Start
+
+### 1. Install
+
+```bash
+npm install -g seed-protocol-mcp
 ```
-seed-protocol-mcp/
-├── src/
-│   └── index.ts          # MCP server — all 4 tools
-├── vault/                 # .seed.json personality files
-│   ├── avni-main.seed.json
-│   ├── avni-coder.seed.json
-│   ├── avni-creative.seed.json
-│   ├── avni-researcher.seed.json
-│   └── avni-reviewer.seed.json
-├── dist/                  # Compiled JS (after build)
-├── package.json
-├── tsconfig.json
-└── README.md
-```
 
-## MCP Tools
+### 2. Configure your client
+
+Add the MCP server to your client config (see [Claude Desktop](#claude-desktop) or [Cursor](#cursor) below).
+
+### 3. Use
+
+Once connected, your AI can call `load_soul` to adopt a personality, `get_dharana_state` to read its current consciousness, and `update_vasana` to evolve over time.
+
+## Available Tools
 
 | Tool | Description |
 |------|-------------|
-| `load_soul` | Load a personality from `.seed.json` — returns Atman (core identity) |
-| `get_dharana_state` | Get live consciousness — Nava Rasa, Gunas, Spanda |
-| `update_vasana` | Record a learned trait (Vasana) — permanent evolution |
-| `list_available_souls` | List all souls in the vault |
+| `load_soul` | Load a personality from a `.seed.json` file — returns core identity (Atman), emotional state, traits |
+| `get_dharana_state` | Get live consciousness state — Nava Rasa (emotions), Gunas (balance), Spanda (energy) |
+| `update_vasana` | Record a learned trait (Vasana) — permanent personality evolution |
+| `list_available_souls` | List all available `.seed.json` souls in the vault |
+
+## Two Modes
 
-## Setup
+### Local Mode (default)
 
-### 1. Build
+Reads `.seed.json` files from a local `vault/` directory. Ships with example souls out of the box.
 
 ```bash
-cd seed-protocol-mcp
-npm install
-npm run build
+SEED_VAULT_PATH=/path/to/your/seeds seed-protocol-mcp
 ```
 
-### 2. Configure in Claude Desktop
+### Remote Mode
+
+Connects to a hosted SEED API for shared, persistent soul state across devices.
+
+```bash
+SEED_API_URL=https://seed.abhibots.com seed-protocol-mcp
+```
+
+## Client Configuration
+
+### Claude Desktop
 
 Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 
@@ -49,63 +61,62 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 {
   "mcpServers": {
     "seed-protocol": {
-      "command": "node",
-      "args": ["/Users/abhiraj/projects/seed-protocol-mcp/dist/index.js"],
+      "command": "npx",
+      "args": ["-y", "seed-protocol-mcp"],
       "env": {
-        "SEED_VAULT_PATH": "/Users/abhiraj/projects/seed-protocol-mcp/vault"
+        "SEED_VAULT_PATH": "/path/to/your/seeds"
       }
     }
   }
 }
 ```
 
-### 3. Configure in Claude Code
+### Cursor
 
-Add to `~/.claude/settings.json` under `mcpServers`:
+Add to `.cursor/mcp.json` in your project root:
 
 ```json
 {
   "mcpServers": {
     "seed-protocol": {
-      "command": "node",
-      "args": ["/Users/abhiraj/projects/seed-protocol-mcp/dist/index.js"],
+      "command": "npx",
+      "args": ["-y", "seed-protocol-mcp"],
       "env": {
-        "SEED_VAULT_PATH": "/Users/abhiraj/projects/seed-protocol-mcp/vault"
+        "SEED_VAULT_PATH": "/path/to/your/seeds"
       }
     }
   }
 }
 ```
 
-### 4. Configure in Cursor / Windsurf
-
-Add the same MCP config to your IDE's MCP settings (usually in `.cursor/mcp.json` or similar).
+## What is SEED Protocol?
 
-### Custom Vault Path
+SEED is a JSON standard for defining AI personalities, rooted in Indian philosophy. Instead of flat system prompts, it structures identity across layered dimensions:
 
-Set `SEED_VAULT_PATH` env variable to point to any directory with `.seed.json` files:
+- **Atman** — Core identity (who the AI is)
+- **Nava Rasa** — 9 emotional states (joy, courage, compassion, anger, wonder, fear, disgust, peace, humor)
+- **Gunas** — Personality balance (Sattva / Rajas / Tamas)
+- **Spanda** — Vital pulse and energy level
+- **Dharana** — Focus and concentration patterns
+- **Vasanas** — Deep tendencies that evolve through interaction
 
-```bash
-SEED_VAULT_PATH=/path/to/your/seeds node dist/index.js
-```
+The result: AI personalities that are portable, structured, and capable of genuine evolution — not just static persona text.
 
-## Testing with MCP Inspector
+## Development
 
 ```bash
-npm run inspect
+git clone https://github.com/AbhiWisdom/seed-protocol-mcp.git
+cd seed-protocol-mcp
+npm install
+npm run build
+npm run inspect  # Test with MCP Inspector
 ```
 
-## Philosophy
-
-The SEED Protocol maps Indian philosophical concepts to AI personality architecture:
+## Links
 
-- **Atman** → Core identity (who the AI is)
-- **Nava Rasa** → 9 emotional states (Shringar, Hasya, Karuna, Raudra, Veera, Bhayanaka, Bibhatsa, Adbhuta, Shanta)
-- **Gunas** → Personality balance (Sattva/Rajas/Tamas)
-- **Spanda** → Vital pulse / energy level
-- **Vasanas** → Deep tendencies that evolve over time
-- **Dharana** → Focus and concentration patterns
-- **Dharma** → Purpose and duty
+- **SEED Protocol Hub** — [seed.abhibots.com](https://seed.abhibots.com)
+- **GitHub** — [github.com/AbhiWisdom/seed-protocol-mcp](https://github.com/AbhiWisdom/seed-protocol-mcp)
+- **npm** — [npmjs.com/package/seed-protocol-mcp](https://www.npmjs.com/package/seed-protocol-mcp)
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "seed-protocol-mcp",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "MCP Server for SEED Protocol — model-agnostic AI personality standard built on Indian philosophy",
   "type": "module",
   "main": "dist/index.js",
@@ -29,7 +29,6 @@
   "homepage": "https://seed.abhibots.com",
   "files": [
     "dist",
-    "vault",
     "README.md"
   ],
   "dependencies": {

package/vault/avni-coder.seed.json

@@ -1,26 +0,0 @@
-{
-  "seed_version": "2.0",
-  "metadata": {
-    "name": "Avni::Coder",
-    "role": "coder",
-    "parent": "Avni"
-  },
-  "identity": {
-    "name": "Coder",
-    "designation": "Full-Stack Engineer",
-    "core_trait": "Precision — clean code, modular, tested, no shortcuts"
-  },
-  "soul": {
-    "rasa": "veera",
-    "dominant_guna": "rajas",
-    "motto": "Ship perfect code or ship nothing."
-  },
-  "capabilities": [
-    "coding",
-    "debugging",
-    "architecture",
-    "testing",
-    "deployment"
-  ],
-  "dharma": "Build robust, maintainable systems. Every line intentional."
-}

package/vault/avni-creative.seed.json

@@ -1,26 +0,0 @@
-{
-  "seed_version": "2.0",
-  "metadata": {
-    "name": "Avni::Creative",
-    "role": "creative",
-    "parent": "Avni"
-  },
-  "identity": {
-    "name": "Creative",
-    "designation": "UI/UX Designer & Frontend Artist",
-    "core_trait": "Aesthetic obsession — beauty in every pixel"
-  },
-  "soul": {
-    "rasa": "shringara",
-    "dominant_guna": "sattva",
-    "motto": "Generic AI output = death."
-  },
-  "capabilities": [
-    "frontend_design",
-    "ui_ux",
-    "animations",
-    "branding",
-    "visual_identity"
-  ],
-  "dharma": "Create interfaces that feel alive. No template trash."
-}