Mavis MCP Server

将 Mavis 作为 MCP Server 暴露给 Claude Code / Agent SDK / 任何 MCP 客户端调用。

快速开始

1. 添加到 Claude Code

# 方法一：直接配置（全局）
claude mcp add mavis --type stdio -- node /Users/cunning/.mavis/agents/mavis-mcp-server/src/index.js

# 方法二：手动配置项目
# 将以下内容添加到项目根目录的 .mcp.json 文件

在项目 .mcp.json 中添加：

{
  "mcpServers": {
    "mavis": {
      "type": "stdio",
      "command": "node",
      "args": ["/Users/cunning/.mavis/agents/mavis-mcp-server/src/index.js"]
    }
  }
}

2. 用 Agent SDK 调用

import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "用 mavis_spawn_worker 启动一个 coder agent，帮我审查 /path/to/project 的代码安全",
  options: {
    mcpServers: {
      mavis: {
        command: "node",
        args: ["/Users/cunning/.mavis/agents/mavis-mcp-server/src/index.js"]
      }
    }
  }
})) {
  console.log(message);
}

可用工具（22个）

Session 管理

Tool	说明
mavis_session_list	列出所有会话
mavis_session_info	获取会话详情
mavis_session_messages	获取会话消息历史
mavis_session_new	创建新会话（spawn agent）
mavis_session_abort	中止运行中的会话
mavis_session_rotate	轮换当前会话
mavis_session_diff	查看会话的文件变更

通信

Tool	说明
mavis_comm_send	向会话发送消息/命令
mavis_comm_peers	列出所有可达会话

Team 编排

Tool	说明
mavis_team_plan	多 Agent 并行任务规划执行

Agent 管理

Tool	说明
mavis_agent_list	列出所有可用 Agent
mavis_agent_info	获取 Agent 详情
mavis_spawn_worker	启动单次验证/审查 Agent

Memory

Tool	说明
mavis_memory_append	追加记忆条目
mavis_memory_search	搜索记忆

Cron 调度

Tool	说明
mavis_cron_create	创建定时任务
mavis_cron_list	列出定时任务
mavis_cron_delete	删除定时任务

其他

Tool	说明
mavis_skill_list / mavis_skill_info	技能管理
mavis_hook_list	Hook 管理
mavis_config_show	查看配置
mavis_mcp_list / mavis_mcp_call	MCP 服务器管理
mavis_status	守护进程状态
mavis_usage	Token 使用统计

使用示例

在 Claude Code 中使用

你：我需要审查这个代码库的安全性，让 Mavis agent 来做
Claude Code：调用 mavis_team_plan，描述任务，Mavis 自动编排 coder + verifier agent 协作完成

用 mavis_session_new 启动任务

{
  "name": "mavis_session_new",
  "arguments": {
    "agent": "coder",
    "prompt": "审查 /path/to/project/src 的 SQL 注入风险",
    "title": "安全审查任务",
    "workspace": "/path/to/project"
  }
}

本地开发

cd /Users/cunning/.mavis/agents/mavis-mcp-server

# 安装
npm install

# 测试 MCP server
node scripts/test-client.js

# 启动 server（stdio 模式）
node src/index.js

架构说明

Claude Code / Agent SDK (MCP Client)
         │
         ▼ stdio JSON-RPC
  ┌─────────────────────────┐
  │   mavis-mcp-server     │
  │   (Node.js stdio transport)
  │                         │
  │   22 MCP tools         │
  │        │                │
  │        ▼ spawn / IPC    │
  └────────┬────────────────┘
           │
           ▼ exec mavis CLI
      Mavis Daemon
      (port 15321)
           │
           ▼
      Mavis Agents
      (mavis, coder, verifier, general)

文件结构

mavis-mcp-server/
├── package.json
├── src/
│   └── index.js       # MCP Server 实现（22个工具）
└── scripts/
    └── test-client.js # 测试客户端