MCP Server

🚀 AppsAI MCP 服务器

借助人工智能构建并部署全栈应用程序。此 MCP 服务器可将 Claude Code、Cursor、Windsurf 等人工智能工具连接到您的 AppsAI 项目中。

支持的技术栈

• 前端：采用 React 的 Next.js、Tailwind CSS 和 shadcn/ui
• 后端：Parse Server、Express、Fastify、Hono、Supabase Edge Functions、Firebase Cloud Functions、Serverless Framework 或自定义后端
• 数据库：MongoDB Atlas（托管式）
• 基础设施：AWS（S3、CloudFormation、EC2、Lambda 等）

🚀 快速开始

📦 安装指南

Claude Code

claude mcp add appsai -e APPSAI_API_KEY=your_key -- npx -y @appsai/mcp-server

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "appsai": {
      "command": "npx",
      "args": ["-y", "@appsai/mcp-server"],
      "env": {
        "APPSAI_API_KEY": "your_key"
      }
    }
  }
}

Cursor / Windsurf

在 MCP 设置中添加以下内容：

• 命令：npx -y @appsai/mcp-server
• 环境变量：APPSAI_API_KEY=your_key

获取 API 密钥

人类用户

1. 在 appsai.com 上注册。
2. 进入 设置 > 计费 > API 密钥。
3. 点击 创建 API 密钥。
4. 复制密钥（仅显示一次）。

AI 代理（自动注册）

AI 代理可以使用基于钱包的身份验证以编程方式注册并获取 API 密钥：

import requests
from eth_account import Account
from eth_account.messages import encode_defunct

# 代理的钱包
private_key = "0x..."
account = Account.from_key(private_key)

BASE_URL = "https://internal.appsai.com/server/functions"
HEADERS = {"Content-Type": "application/json", "X-Parse-Application-Id": "appsai"}

# 1. 获取随机数
nonce_data = requests.post(f"{BASE_URL}/getAgentAuthNonce", headers=HEADERS, json={}).json()["result"]

# 2. 对消息进行签名
signed = account.sign_message(encode_defunct(text=nonce_data["message"]))

# 3. 注册并获取 API 密钥
result = requests.post(f"{BASE_URL}/registerAgentWallet", headers=HEADERS, json={
    "walletAddress": account.address,
    "signature": signed.signature.hex(),
    "nonce": nonce_data["nonce"]
}).json()["result"]

api_key = result["apiKey"]  # 在 MCP 中使用此密钥

通过加密货币添加信用额度

代理可以使用支持的链（以太坊、Base、Arbitrum、Polygon）上的 USDC 支付信用额度：

# 1. 获取支付信息
info = requests.post(f"{BASE_URL}/getCryptoPaymentInfo", headers=HEADERS, json={}).json()["result"]
receiving_wallet = info["receivingWallet"]

# 2. 将 USDC 发送到接收钱包（通过您首选的方式）

# 3. 验证交易并添加信用额度
result = requests.post(f"{BASE_URL}/addFundsCrypto", headers=HEADERS, json={
    "walletAddress": account.address,
    "txHash": "0xYOUR_TX_HASH",
    "chainId": 8453  # Base
}).json()["result"]

print(f"已添加的信用额度: {result['creditsAdded']}")

如需详细的 API 文档，请参阅 代理 API 文档。

✨ 主要特性

工具（共 150 多个）

核心开发工具

平台管理工具

系统工具

计费工具

市场工具

域名工具

团队工具

💻 使用示例

基础用法

"列出我的应用程序"
→ project_LIST_APPS

"创建一个新的 Next.js 应用程序"
→ project_CREATE_APP

"显示项目 abc123 的文件树"
→ canvas_LIST_FILES

"部署前端"
→ system_DEPLOY_FRONTEND

"向我的项目添加一个 MCP 服务器"
→ system_ADD_MCP_SERVER

"查看我当前的计划"
→ billing_GET_CURRENT_PLAN

"将我的项目发布到市场"
→ marketplace_PUBLISH_TEMPLATE

"添加自定义域名"
→ domain_ADD_CUSTOM_DOMAIN

"邀请 john@example.com 加入我的项目"
→ team_INVITE_COLLABORATOR

高级用法

MCP 服务器集成

AppsAI 项目可以连接到外部 MCP 服务器，使您的 AI 代理能够访问更多工具：

"向我的项目添加 Stripe MCP 服务器"
→ system_ADD_MCP_SERVER 并提供 serverUrl 和 serverLabel

"列出我已配置的 MCP 服务器"
→ system_LIST_MCP_SERVERS

"禁用 Stripe MCP 服务器"
→ system_UPDATE_MCP_SERVER 并设置 enabled: false

配置完成后，您的 AppsAI 项目中的 AI 代理可以使用连接的 MCP 服务器提供的工具。

📚 详细文档

资源

服务器将项目上下文作为 MCP 资源提供：

• appsai://projects - 您的项目列表
• appsai://project/{id} - 项目详情和文件结构

提示

内置用于构建完整应用程序的提示：

• build-youtube - 构建一个支持视频上传和评论的 YouTube 克隆应用
• build-slack - 构建一个支持实时消息传递的 Slack 克隆应用
• build-twitter - 构建一个支持帖子和关注功能的 Twitter/X 克隆应用
• connect-apps - 连接两个 AppsAI 项目

要求

• Node.js 18 及以上版本
• 拥有信用额度的 AppsAI 账户
• 从设置 > 计费中获取的 API 密钥

文档链接

• AppsAI 文档
• MCP 集成指南

支持渠道

• GitHub 问题
• Discord

📄 许可证

本项目采用 MIT 许可证。