Corn Hub — AI Agent Intelligence

📋 Prerequisites

⬢

Node.js 22+

Required for the MCP server runtime

📦

pnpm 10+

Monorepo package manager

🐳

Docker (optional)

Only needed for the Analytics Dashboard

1Clone & Build

# Clone the repository
git clone https://github.com/Min9802/CornMCP.git
cd CornMCP

# Install dependencies & build
pnpm install
pnpm build

2Connect to Your IDE

Add Corn Hub as an MCP server in your IDE. Replace the path with your actual clone location.

⚡ Antigravity / Codex (VS Code)

// STDIO (local):
{
  "mcpServers": {
    "corn": {
      "command": "node",
      "args": ["/path/to/corn-hub/apps/corn-mcp/dist/cli.js"]
    }
  }
}

// HTTP (remote):
{
  "mcpServers": {
    "corn-hub": {
      "url": "https://cornhub.min-services.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

▶ Cursor

1. Settings → Features → MCP

2. Click + Add new MCP server

3. Name: corn · Type: command

4. Command: node /path/to/corn-hub/apps/corn-mcp/dist/cli.js

🟢 Claude Code

claude mcp add corn -- node /path/to/corn-hub/apps/corn-mcp/dist/cli.js

3Launch Dashboard (optional)

docker compose -f infra/docker-compose.yml up -d --build

Dashboard

https://cornhub.min-services.com

API

https://cornhub.min-services.com

MCP Gateway

https://cornhub.min-services.com

Qdrant

http://localhost:6333

⚙️ Environment Variables

Variable	Default	Description
`OPENAI_API_KEY`	—	Voyage AI / OpenAI API key for embeddings
`OPENAI_API_BASE`	https://api.voyageai.com/v1	Embedding API base URL
`MEM9_EMBEDDING_MODEL`	voyage-code-3	Primary embedding model
`MEM9_EMBEDDING_DIMS`	1024	Embedding vector dimensions
`MEM9_FALLBACK_MODELS`	voyage-4-large,...	Fallback model rotation chain
`DASHBOARD_API_URL`	https://cornhub.min-services.com	Dashboard API URL
`DASHBOARD_API_KEY`	—	API key for MCP → API communication
`AUTH_JWT_SECRET`	changeme	JWT secret for user authentication
`CORS_ORIGIN`	http://localhost:3000	Allowed CORS origin for dashboard
`GEMINI_API_KEY`	—	Google Gemini API key (optional)
`QDRANT_URL`	http://<host>:6333	Vector database URL

📝 Notes

⚡Model Rotation: When the primary Voyage model hits rate limits, Corn Hub auto-rotates: voyage-code-3 → voyage-4-large → voyage-4 → voyage-code-2 → voyage-4-lite
✅Quality Gates: All plans must score ≥80% on corn_plan_quality before execution. All tasks must submit a corn_quality_report ≥60/100.
💾Local Fallback: If no API key is set, embeddings use a local hash-based provider (lower quality but zero external dependencies).
🪟Windows: Use forward slashes or escaped backslashes in JSON config paths. The MCP server works on Windows, macOS, and Linux.
⚠️Build Required: You must run pnpm build after cloning. The dist/ folder is not committed to Git.