GPTaria MCP

GPTaria MCP

GPTaria MCP 将你的 AI 助手 — Claude Code、Claude Desktop、 Cursor、Windsurf — 连接到 GPTaria，并可直接在编辑器中完成整个流程：发布项目简介、提交可运行的原型、与对方联系、发布作品集案例，以及购买访问权限 — 共 23 个工具。这是一个面向 GPTaria REST API 的 MCP（Model Context Protocol）服务。

• 使用自己的语言撰写 — 内容会自动翻译成平台支持的所有语言（系统会自动检测文本所用语言）。
• 价格以 UAH（₴）计价 — 使用乌克兰银行发行的银行卡付款；list_services（免费）会列出准确价格。
• 按 Token 计费 — 大多数操作会消耗少量 AI Token 余额；get_balance 和 list_services 免费。任何付款都会由你确认。

GPTaria 是一个信息平台，客户在此发布项目简介，开发者则提交可运行的原型。此仓库是面向开发者的接口：一个封装 GPTaria REST API 的 MCP 服务，以及可直接安装的 Agent Skills，可将这些工具转化为引导式工作流。

REST API  →  MCP server  →  Agent skills
(foundation)  (AI tools)     (guided workflows)

工具

工具	适用对象	功能
list_projects	任何人	列出可供回应的开放项目（简介）
list_responses	客户	列出某个项目的回应，以便在自己的 AI 中处理
list_my_responses	开发者	列出你已回应的项目及其状态、获胜和报价标记
list_project_comments	任何人	列出客户对项目的补充说明
get_response_thread	开发者	查看你自己回应的时间线（评论和版本）
list_conversations	任何人	查看消息收件箱（未读数、最新消息）
get_conversation	任何人	查看单个会话的时间线（以你的语言显示）
get_balance	任何人	免费 — AI Token 余额和访问状态
list_services	任何人	免费 — 商店价目表（以 ₴ 计价）
create_project	客户	通过 Pro 订单发布项目简介
create_project_comment	客户	为自己的项目添加公开说明
create_response	开发者	提交项目回应（提案）
post_proposal_update	开发者	在你的讨论串中发布更新后的报价或评论
create_case	开发者	发布作品集案例（默认保存为草稿）
generate_case_summary	开发者	生成案例的 AI 摘要区块
update_profile / get_profile	任何人	编辑 / 查看自己的公开个人资料
offer_project / accept_project / decline_project	客户 / 开发者	报价→接受流程
send_message / mark_conversation_read	任何人	给对方发送消息
buy_service	任何人	免费工具 — 购买访问通行证 / AI 套餐 / 秘密模式 / 案例验证（返回结账链接）

每个工具都会遵守与网站相同的规则 — 账户角色、有效访问通行证、Super-Expert 时段，以及必要时的付款。没有绕过规则的途径；请先使用 sandbox 密钥进行测试。

快速开始

1. 创建 API 密钥，访问 gptaria.com/settings → API keys。原始密钥只会显示一次 — 请将其保存为 GPTARIA_API_KEY。

   • 正式密钥：gptaria_live_…
   • 沙盒密钥：gptaria_sbx_… — 每次调用都会根据真实规则验证， 但绝不会持久化（{ "dry_run": true }）。安全调试后，再切换到正式环境。

2. 连接 — 选择一种方式：

   • 托管连接器，无需安装（claude.ai / Claude Desktop → Settings → Connectors → Add custom connector）：

     https://www.gptaria.com/api/mcp?api_key=YOUR_KEY
     

   • 本地安装，通过 npm — 使用 npx -y gptaria-mcp，并在服务的 env 中设置 GPTARIA_API_KEY（Claude Code、Cursor、Windsurf）。

   各客户端的确切配置以及完整的 23 个工具参考，请参阅 docs/getting-started.md。

3. 安装技能（可选的便捷层）— 将 skills/ 中需要的文件夹 复制到助手的技能目录。

没有 MCP？每个端点也都是普通的 REST 调用 — 请参阅 docs/api.md 和 examples/curl.md。

安装为 Claude Code 插件

在 Claude Code 中，将此仓库添加为插件市场并安装 — MCP 服务（来自 npm）和技能将一并安装：

/plugin marketplace add gptaria-mcp/gptaria-mcp
/plugin install gptaria-mcp

请先在环境中设置 GPTARIA_API_KEY。

内容

• mcp-server/ — MCP 服务（Node、stdio）及其设置
• skills/ — 三个 Agent Skills（发布项目、提交响应、 发布案例）
• docs/ — 入门指南、 REST API 参考、Pro 订单流程
• examples/ — MCP 客户端配置和 curl 示例

安装选项

渠道	方式
npm	npx -y gptaria-mcp（或 npm i -g gptaria-mcp）— 请参阅入门指南
Claude Code 插件	/plugin marketplace add gptaria-mcp/gptaria-mcp → /plugin install gptaria-mcp
从源代码安装	克隆仓库，运行 cd mcp-server && npm install && node index.mjs

分发清单位于仓库中：server.json（MCP 注册表）、 .claude-plugin/（Claude Code）、smithery.yaml（Smithery）。

链接

• 平台：https://www.gptaria.com
• MCP：https://modelcontextprotocol.io
• 贡献：CONTRIBUTING.md · 安全：SECURITY.md · 更新日志

许可证

MIT © GPTaria