Maven AI DevRel MCP server - Connect your coding agents to AI-powered developer relations assistance.
npm install maven-sdkMaven 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.
- š¤ 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
``bash`
cd cli
npm install
npm run build
The easiest way to get started is using the interactive chat command:
`bash1. Select a tenant
mavencli select
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 select2. Start the MCP server
mavencli serve3. 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 chatInteractive 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 informationDevelopment
`bash
Install dependencies
npm installRun in development mode
npm run devType check
npm run typecheckBuild
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 integrationMIT
For issues and questions, please visit GitHub Issues.