Cloudflare Fullstack Suite

MCP运维云端

提供方 cwybruce

运维云端 未标注 Token 社区 / 第三方

Cloudflare全栈开发套件是一个集成了Cloudflare Pages、Workers、GraphQL和Mastra AI Agents的现代化Web应用开发解决方案,适用于构建高效、可扩展的云原生应用。

一句话选型结论

按资料字段整理

Cloudflare Fullstack Suite 属于运维云端类 MCP 服务器,传输方式未标注,Token,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式未标注 鉴权Token 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

全栈开发本地部署云原生ServerlessAI集成GraphQL

安装与配置

未标注 Token
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 基础信息齐全,可以先按官方文档接入试跑。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Cloudflare Fullstack Suite当前 未标注 未标注 未标注 无 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方cwybruce上游标注的维护方 cwybruce
分类运维云端本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.8 KB
来自项目仓库与上游目录的原文,未做删改

🌐 Cloudflare 全栈开发套件

> Week 1 项目 | Cloudflare Pages + Workers + GraphQL + Mastra AI Agents

Live Demo · 项目文档 · 视频演示


📋 项目概述

这是一个完整的 Cloudflare 全栈开发项目,展示了如何使用 Cloudflare 的生态系统构建现代化的 Web 应用。

🎯 项目目标

  • ✅ 掌握 Cloudflare Pages 部署与 CI/CD
  • ✅ 学习 Cloudflare Workers 开发
  • ✅ 实现 GraphQL API 通信
  • ✅ 开发 Mastra AI Agents
  • ✅ 集成 MCP 服务

🗂️ 项目结构```

cloudflare-fullstack-suite/
├── packages/
│ ├── frontend/ # React 前端项目
│ │ ├── src/
│ │ │ ├── components/ # 组件
│ │ │ ├── pages/ # 页面
│ │ │ ├── graphql/ # GraphQL 查询
│ │ │ └── App.tsx
│ │ ├── package.json
│ │ └── vite.config.ts
│ │
│ ├── workers/ # Cloudflare Workers
│ │ ├── src/
│ │ │ ├── index.ts # Worker 入口
│ │ │ ├── graphql/ # GraphQL Schema
│ │ │ ├── services/ # 业务逻辑
│ │ │ │ ├── ai.ts # AI 服务 (DeepSeek/OpenAI)
│ │ │ │ └── mcp.ts # MCP 服务集成
│ │ │ └── utils/
│ │ ├── wrangler.toml
│ │ └── package.json
│ │
│ └── mastra-agents/ # Mastra AI Agents
│ ├── src/
│ │ ├── agents/ # Agent 定义
│ │ ├── tools/ # Agent 工具
│ │ └── index.ts
│ ├── wrangler.toml
│ └── package.json
│
├── docs/
│ ├── architecture.md # 架构设计
│ ├── deployment.md # 部署指南
│ └── api.md # API 文档
│
├── .github/
│ └── workflows/
│ └── deploy.yml # CI/CD 配置
│
├── package.json
├── turbo.json # Turborepo 配置
└── README.md


---

## ✨ 核心功能

### 📦 项目1: Pages + Workers 通信

**功能描述**

- ✅ React 前端部署到 Cloudflare Pages
- ✅ GitHub Actions 自动化 CI/CD
- ✅ Workers 提供 GraphQL API
- ✅ 前端通过 GraphQL 与 Workers 通信

**技术栈**

- Frontend: React + Vite + TypeScript + Apollo Client
- Backend: Cloudflare Workers + GraphQL Yoga
- Deployment: Cloudflare Pages + GitHub Actions

**核心代码示例**```typescript
// workers/src/index.ts
import { createYoga } from 'graphql-yoga'
import { schema } from './graphql/schema'

export default {
async fetch(request: Request, env: Env): Promise {
const yoga = createYoga({ schema, graphiql: true })
return yoga.fetch(request, env)
}
}
``````typescript
// frontend/src/graphql/queries.ts
import { gql } from '@apollo/client'

export const GET_AI_RESPONSE = gql`
query GetAIResponse($prompt: String!) {
aiResponse(prompt: $prompt) {
content
model
usage {
tokens
}
}
}
`

🤖 项目2: AI 服务集成

功能描述

  • ✅ Workers 请求 DeepSeek/OpenAI API
  • ✅ 环境变量管理 API Keys
  • ✅ 错误处理和重试机制
  • ✅ 流式响应支持

核心代码示例``typescript // workers/src/services/ai.ts export async function callDeepSeek( prompt: string, env: Env ): Promise { const response = await fetch('https://api.deepseek.com/v1/chat/completions', { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization':Bearer ${env.DEEPSEEK_API_KEY}`
},
body: JSON.stringify({
model: 'deepseek-chat',
messages: [{ role: 'user', content: prompt }]
})
})

return response.json()
}


---

### 🔧 项目3: MCP 服务集成

**选择的 MCP 服务**

1. **GitHub MCP** - 代码管理和自动化
- 自动创建 Issue
- Pull Request 管理
- 代码审查辅助

2. **[你选择的第二个 MCP]** - [功能描述]
- 功能1
- 功能2

**集成示例**```typescript
// workers/src/services/mcp.ts
import { createMCPClient } from '@modelcontextprotocol/sdk'

export async function executeGitHubAction(
action: string,
params: any,
env: Env
) {
const client = createMCPClient({
apiKey: env.MCP_API_KEY
})

return await client.execute('github', action, params)
}

🎯 项目4: Mastra AI Agents

Agent 功能

  • ✅ 实用的任务自动化
  • ✅ 多步骤推理能力
  • ✅ 部署到 Cloudflare Workers
  • ✅ 低延迟响应

Agent 示例```typescript
// mastra-agents/src/agents/code-helper.ts
import { createAgent } from '@mastra/core'

export const codeHelperAgent = createAgent({
name: 'code-helper',
description: '代码助手 Agent',
tools: [
{
name: 'analyze-code',
description: '分析代码质量',
execute: async (code: string) => {
// 分析逻辑
}
},
{
name: 'suggest-improvements',
description: '提供改进建议',
execute: async (analysis: any) => {
// 建议逻辑
}
}
]
})


---

## 🚀 快速开始

### 前置要求

- Node.js 18+
- npm 或 pnpm
- Cloudflare 账号
- GitHub 账号

### 本地开发```bash
# 克隆仓库
git clone https://github.com/cwybruce/cloudflare-fullstack-suite.git
cd cloudflare-fullstack-suite

# 安装依赖
npm install

# 配置环境变量
cp .env.example .env
# 编辑 .env 添加你的 API Keys

# 启动开发服务器
npm run dev

# 在另一个终端启动 Worker
npm run dev:worker

部署到 Cloudflare```bash

部署 Workers

npm run deploy:worker

部署 Pages (通过 GitHub Actions 自动部署)

git push origin main


---

## 📖 文档

### 架构设计

查看 架构文档 了解系统设计。

**系统架构图**```
┌─────────────┐
│   用户浏览器  │
└──────┬──────┘
│
│ HTTPS
▼
┌─────────────────────────────┐
│  Cloudflare Pages (Frontend) │
│  - React SPA                 │
│  - Apollo Client             │
└──────────┬──────────────────┘
│
│ GraphQL
▼
┌──────────────────────────────┐
│  Cloudflare Workers (API)    │
│  - GraphQL Yoga              │
│  - Business Logic            │
└──────┬───────────────────┬───┘
│                   │
│                   │
▼                   ▼
┌─────────────┐    ┌──────────────┐
│ DeepSeek API │    │  MCP Services │
└─────────────┘    └──────────────┘

API 文档

查看 API 文档 了解接口详情。

GraphQL Schema```graphql
type Query {
aiResponse(prompt: String!): AIResponse
mcpExecute(service: String!, action: String!, params: JSON): MCPResult
}

type AIResponse {
content: String!
model: String!
usage: Usage!
}

type Usage {
tokens: Int!
cost: Float
}


### 部署指南

查看 部署指南 了解部署流程。

---

## 🔧 环境变量

创建 `.env` 文件并添加以下变量:```env
# DeepSeek API
DEEPSEEK_API_KEY=your_deepseek_api_key

# OpenAI API (可选)
OPENAI_API_KEY=your_openai_api_key

# MCP Services
MCP_API_KEY=your_mcp_api_key

# Cloudflare
CLOUDFLARE_API_TOKEN=your_cf_api_token
CLOUDFLARE_ACCOUNT_ID=your_account_id

📊 性能指标

  • ⚡ 冷启动时间: < 50ms (Workers)
  • 🌍 全球延迟: < 100ms (CDN)
  • 💰 成本: 免费额度内 (10万请求/天)
  • 📈 可扩展性: 无限 (Cloudflare Edge Network)

🎥 演示视频

📹 点击观看完整演示

演示内容

  1. 前端页面展示
  2. GraphQL API 调用
  3. AI 服务集成
  4. MCP 服务演示
  5. Mastra Agent 运行

📸 截图

前端界面

GraphQL Playground

Cloudflare Dashboard


🛠️ 技术栈详解

前端技术

  • React 18 - UI 框架
  • Vite - 构建工具
  • TypeScript - 类型安全
  • Apollo Client - GraphQL 客户端
  • Tailwind CSS - 样式方案

后端技术

  • Cloudflare Workers - Serverless 运行时
  • GraphQL Yoga - GraphQL 服务器
  • Hono - 轻量级路由框架
  • Wrangler - Cloudflare CLI

AI & 自动化

  • DeepSeek API - 中文 AI 模型
  • OpenAI API - GPT 模型
  • Mastra - AI Agents 框架
  • MCP - Model Context Protocol

🎓 学习收获

技术能力

  • ✅ Cloudflare 生态系统掌握
  • ✅ GraphQL API 设计
  • ✅ Serverless 架构理解
  • ✅ AI 服务集成经验
  • ✅ CI/CD 流程实践

最佳实践

  • ✅ 环境变量管理
  • ✅ 错误处理机制
  • ✅ API 安全设计
  • ✅ 性能优化技巧
  • ✅ 成本控制策略

🐛 问题解决

常见问题

Q: Workers 部署失败?

A: 检查 wrangler.toml 配置和账户权限。

Q: API 调用超时?

A: 增加 Worker 的超时时间或优化 AI 请求。

Q: Pages 部署后页面空白?

A: 检查构建输出路径和路由配置。


📝 开发笔记

技术难点

  1. GraphQL Schema 设计
    - 解决方案: 使用 Code-First 方式

  2. Workers 环境变量
    - 解决方案: 使用 wrangler secrets

  3. CORS 配置
    - 解决方案: 在 Worker 中添加 CORS headers

优化记录

  • 优化1: GraphQL 查询缓存 → 减少 50% API 调用
  • 优化2: Worker 响应压缩 → 减少 70% 传输大小
  • 优化3: 静态资源 CDN → 提升 3倍加载速度

🔗 相关链接

  • 📚 Cloudflare Workers 文档
  • 📚 Cloudflare Pages 文档
  • 📚 GraphQL Yoga 文档
  • 📚 Mastra 文档

🤝 贡献

欢迎提 Issue 和 PR!


📄 许可证

MIT License - 查看 LICENSE 文件


🙏 致谢

  • Cloudflare 团队
  • GraphQL 社区
  • Mastra 开发者

⭐ 如果这个项目对你有帮助,欢迎 Star!

Made with ❤️ by CwyBruce

返回作品集

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
Cloudflare Fullstack Suite 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Cloudflare Fullstack Suite 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Cloudflare Fullstack Suite 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Cloudflare Fullstack Suite 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Cloudflare Fullstack Suite 能提供哪些能力?

资料显示能力标签包括 全栈开发、云原生、GraphQL、Token认证。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。