MCP 服务器

joppa mcp 是一个运行在 stdio 上的 MCP（Model Context Protocol）服务器。编程助手可以通过它查看你的项目及其域名、启动服务、读取日志、创建数据库或项目，以及读取 .env。

接入助手

最简单的方式：设置 › 命令行 › 接入助手。也可以在终端中操作：

joppa mcp install                           # Claude Code、Claude Desktop 和 Cursor 中已安装的
joppa mcp install --client cursor --dry-run # 显示将要写入的内容
joppa mcp uninstall

客户端	Joppa 注册的位置
Claude Code	claude mcp add --scope user，否则写入其配置文件
Claude Desktop	claude_desktop_config.json
Cursor	~/.cursor/mcp.json

只会写入 mcpServers.joppa 这一项，文件其余部分保持不变。之后请重启助手。

--client 可接受 claude-code、claude-desktop、cursor 或 all。

工具

工具	作用
get_status	代理、CA、项目和服务的状态
list_projects	项目、它们的域名及健康状态
list_services	服务及其状态
start_service、stop_service	启动或停止服务
service_logs	服务的日志（lines：默认 100，最多 2,000）
list_databases	某个服务器上的数据库及其 URL
create_database	创建数据库（service、name、extensions）
get_env	项目的 .env，除非使用 reveal，否则隐藏机密
start_proxy、stop_proxy	启动或停止代理
set_route_enabled	启用或停用域名
add_project	添加文件夹，使用检测到的或指定的域名
add_service	添加服务（engine、version、port、start）
list_templates	项目模板及其选项
create_project	从模板创建项目（用 dry_run 查看命令）
create_project_status	跟踪或取消正在进行的创建
open_app	显示 Joppa 窗口

请求示例

• “启动 PostgreSQL，并创建一个带 pgvector 的 blog 数据库。”
• “为什么 api.kinosante.test 离线了？看看日志。”
• “在 ~/Code 中创建一个名为 docs 的 Astro 项目，并把它添加到 Joppa。”