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

``bash
cd cli
npm install
npm run build
`

Quick Start

$3

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

`bash


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.

$3

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

`bash


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:

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

$3

- 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

$3

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 - Maven API URL (default: http://localhost:3000)

Example:
`bash
mavencli select


Shows interactive list → Select with arrow keys → Press Enter


`

$3

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 - Maven API URL (default: http://localhost:3000)

Example:
`bash
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

`

$3

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

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

MCP Tool: maven_chat

The MCP server exposes one tool:

$3

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

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

Output:
`typescript
{
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

`bash


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.