Maven AI DevRel MCP Server

Maven AI DevRel is an MCP (Model Context Protocol) server that connects your coding agents (like Claude Code, Cursor, etc.) to AI-powered developer relations assistance.

Features

• 🤖 AI-Powered DevRel Assistant: Uses the exact same Mastra agent as your email threads
• 🔍 Full Context Search: Automatically searches docs, codebase, and memory using the same tools:
  • getMemory - Checks Hyperspell for user context
  • searchDocs - Searches official documentation
  • searchCodebase - Finds code examples in GitHub repos
  • createGithubIssue - Escalates when needed
• 💬 Interactive CLI Chat: Chat directly in your terminal with markdown rendering and conversation history
• 🎯 Tenant-Specific Context: Each tenant has their own knowledge base and customized assistance
• 🔌 MCP Integration: Works seamlessly with any MCP-compatible coding agent
• 📊 Built on Convex: Uses your existing Convex database and schemas
• 📝 Persistent History: Conversation history saved per tenant and preserved across sessions

Installation

cd cli
npm install
npm run build

Quick Start

Option A: Interactive CLI Chat (Recommended)

The easiest way to get started is using the interactive chat command:

# 1. Select a tenant
mavencli select

# 2. Start chatting!
mavencli chat

This starts an interactive conversation directly in your terminal with full markdown rendering, colors, and conversation history.

Option B: MCP Server (For Coding Agents)

If you want to use Maven with coding agents like Claude Code or Cursor:

# 1. Select a tenant
mavencli select

# 2. Start the MCP server
mavencli serve

# 3. Configure your MCP client (e.g., Claude Code)

Add this to your MCP client configuration:

{
  "mcpServers": {
    "maven-ai-devrel": {
      "url": "http://127.0.0.1:7090/mcp"
    }
  }
}

What You Can Do

• Get DevRel strategy advice
• Generate blog posts and technical content
• Plan community engagement activities
• Create social media content for developers
• Search your docs and codebase for answers
• And more!

Commands

mavencli select

Select a tenant to work with. This fetches the list of available tenants from your Maven instance and saves your selection locally.

Options:

• --api-url <url> - Maven API URL (default: http://localhost:3000)

Example:

mavencli select
# Shows interactive list → Select with arrow keys → Press Enter

mavencli chat

Start an interactive chat session with Maven AI DevRel in your terminal.

Features:

• 💬 Interactive conversation with full context from docs and codebase
• 🎨 Markdown rendering with syntax highlighting for code blocks
• 📝 Conversation history saved per tenant in .maven/history/
• 🔍 Same agent as email threads (searches docs, codebase, memory)

Special Commands:

• /help - Show available commands
• /clear - Clear conversation history for current tenant
• /history - Display full conversation history
• Ctrl+C - Exit chat (history is auto-saved)

Options:

• --api-url <url> - Maven API URL (default: http://localhost:3000)

Example:

mavencli chat

# Interactive session:
You: How do I create a blog post?
🤖 Assistant: [Searches docs and codebase...]
To create a blog post, you can...

You: What about adding images?
🤖 Assistant: ...

# Press Ctrl+C to exit

mavencli serve

Start the MCP server with the selected tenant's context for use with coding agents.

Options:

• --port <number> - Port to listen on (default: 7090)
• --api-url <url> - Maven API URL (default: http://localhost:3000)

MCP Tool: maven_chat

The MCP server exposes one tool:

maven_chat

Chat with the Maven AI DevRel assistant for guidance and content creation.

Input:

{
  message: string;              // Your question or request
  conversationHistory?: {       // Optional conversation context
    role: "user" | "assistant";
    content: string;
  }[];
}

Output:

{
  response: string;             // The assistant's response
  conversationId?: string;      // Conversation ID for tracking
}

Architecture

┌─────────────────┐
│  Coding Agent   │  (Claude Code, Cursor, etc.)
│  (MCP Client)   │
└────────┬────────┘
         │ MCP Protocol
         ↓
┌─────────────────┐
│   mavencli      │  Local MCP Server
│   serve         │
└────────┬────────┘
         │ HTTP API
         ↓
┌─────────────────┐
│   Maven Web     │  Next.js App + Mastra DevRel Agent
│   App           │  (searches docs, codebase, memory)
└────────┬────────┘
         │
         ↓
┌─────────────────┐
│   Database      │  Tenant data & knowledge base
│   (Convex)      │
└─────────────────┘

Configuration

The CLI stores configuration in .maven/:

• .maven/current-tenant - Selected tenant information

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Type check
npm run typecheck

# Build
npm run build

Environment Variables

The Maven web app requires:

• NEXT_PUBLIC_CONVEX_URL - Your Convex deployment URL
• OPENAI_API_KEY - OpenAI API key for LLM integration (paid by tenant)
• HYPERSPELL_API_KEY - (Optional) For memory storage
• AGENTMAIL_API_KEY - (Optional) For email integration

License

MIT

Support

For issues and questions, please visit GitHub Issues.