paretostudio-mcp

paretostudio-mcp

在 Claude Code、Cursor 和任何 MCP 客户端中读取你的 ParetoStudio 提示词、Agent 和技能库。将 Agent 和技能作为文件安装到 Claude Code 中。

快速开始

1. 获取 API 密钥

前往 paretostudio.io/settings，进入 Developer，然后创建 API Key。

2. 配置客户端

Claude Code（项目根目录中的 .mcp.json）：

{
  "mcpServers": {
    "paretostudio": {
      "command": "npx",
      "args": ["-y", "paretostudio-mcp@latest"],
      "env": {
        "PARETOSTUDIO_API_KEY": "psk_your_key_here"
      }
    }
  }
}

Cursor（Settings > MCP）：

{
  "mcpServers": {
    "paretostudio": {
      "command": "npx",
      "args": ["-y", "paretostudio-mcp@latest"],
      "env": {
        "PARETOSTUDIO_API_KEY": "psk_your_key_here"
      }
    }
  }
}

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "paretostudio": {
      "command": "npx",
      "args": ["-y", "paretostudio-mcp@latest"],
      "env": {
        "PARETOSTUDIO_API_KEY": "psk_your_key_here"
      }
    }
  }
}

Codex（~/.codex/config.toml）：

[mcp_servers.paretostudio]
command = "npx"
args = ["-y", "paretostudio-mcp@latest"]

[mcp_servers.paretostudio.env]
PARETOSTUDIO_API_KEY = "psk_your_key_here"

3. 开始使用

让 Codex、Claude 或 MCP 客户端“列出我的提示词”或“安装我的 Agent”——这些工具会自动启用。

可用工具

工具	描述
list_prompts	列出库中的所有提示词
get_prompt	获取完整的提示词内容（全部 6 个步骤）
search_prompts	按标题或描述搜索提示词
list_agents	列出所有 Agent
get_agent	获取包含完整配置的 Agent
search_agents	搜索 Agent
list_skills	列出所有技能
get_skill	获取包含完整配置的技能
search_skills	搜索技能
install_skill	为 Claude 或 Codex 项目布局安装技能
install_agent	将 Agent 下载到 .claude/agents/
install_bundle	一次操作安装 Agent 和技能
create_prompt	创建新提示词
update_prompt	更新提示词
delete_prompt	删除提示词
create_skill	创建新技能
update_skill	更新技能
delete_skill	删除技能
create_agent	创建新 Agent
update_agent	更新 Agent
delete_agent	删除 Agent

默认情况下，安装工具不会覆盖现有文件。只有在确实要替换已安装的 Agent 或技能时，才传入 overwrite: true。 对于 Codex 项目技能，调用 install_skill 并设置 client: "codex"；技能会写入 .agents/skills/<name>/SKILL.md，而不是 .claude/skills/。

写入工具遵循你所用套餐的库数量上限（Free：5 个提示词 / 2 个 Agent / 2 个技能；Pro 和 Team：不限）。

速率限制

套餐	每日请求数	写入权限
Free	50	是——受套餐上限约束（5 个提示词 / 2 个 Agent / 2 个技能）
Pro	500	是——不限
Team	500	是——不限，团队共享库

环境变量

变量	必需	默认值	描述
PARETOSTUDIO_API_KEY	是	--	你的 API 密钥（以 psk_ 开头）
PARETOSTUDIO_API_URL	否	https://paretostudio.io	API 基础 URL

源码

服务端源码位于 ParetoStudio 应用仓库中，因为它会导入 API 强制执行的相同业务规则（src/rules/）——如果在此处重复定义，这两处规则就可能出现偏差。本仓库是已发布软件包的公开托管位置：清单注册表会读取这里的内容，包括配置示例和文档。

发布会自动进行：版本号更新合入 main 后会发布到 npm；CI 门禁会阻止服务端自上次版本更新后有变更的构建。

链接

• 文档
• 获取 API 密钥
• ParetoStudio

隐私政策

该服务是运行在你计算机上的本地进程。它只会使用你提供的 API 密钥与 ParetoStudio API（https://paretostudio.io，或你配置的 PARETOSTUDIO_API_URL）通信，不会向其他任何地方发送信息。 隐私政策：paretostudio.io/privacy

安全

请参阅 SECURITY.md。请将漏洞报告发送至 [email protected]——不要在公开 issue 中报告。

许可证

MIT——请参阅 LICENSE。