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 許可證。