使用说明
GitHub 项目管理器
基于AI的GitHub项目V2及智能自动化问题管理。
🔗(此符号在中文中无直接对应含义,通常用于表示链接或连接,在此处可保留原样或根据上下文解释为“链接”或“连接”) 应用URLhttps://github-projects.deco.page/(这个网址本身在中文中不直接翻译,但可以说明其含义为:一个展示GitHub项目的网页或平台,具体名称或功能需根据实际内容确定)
一个全面的MCP(模型上下文协议)服务器,用于通过人工智能管理GitHub项目V2和问题。专为希望实现GitHub工作流程自动化的团队而设计,具备智能任务管理、问题追踪和项目组织功能。
🚀 快速入门
安装
- 前往您的Deco工作区 在 admin.decocms.com 翻译为中文是:“Decocms 管理后台(或管理员控制台)”。这里,“admin”通常代表“管理员”或“管理后台”,“decocms.com”是网站或平台的域名,表示这是一个与 Decocms 相关的管理界面或控制台
- 导航至应用 在你的项目中
- 搜索“GitHub 项目管理器” 或者直接从以下位置安装:
- 应用网址:
https://github-projects.deco.page/
- 应用网址:
- 安装期间进行配置:
- GitHub 令牌 (必需):具有(所需权限的)个人访问令牌
repo,project,以及read:org范围(或领域) - 默认组织 (可选):您的主要GitHub组织(例如。,
deco-cx)
- GitHub 令牌 (必需):具有(所需权限的)个人访问令牌
创建GitHub令牌
- 前往 GitHub 设置 → 开发者设置 → 个人访问令牌 → 代币(经典版)
- 点击“生成新令牌(经典版)”
- 选择范围:
- ✅
repo- 完全控制私有仓库 - ✅ 翻译为中文是:✅(这个符号本身在中文中通常不直接翻译,而是保留原样使用,表示“正确”或“确认”的意思。)如果非要给出一个解释性的翻译,可以是“正确/确认”。
project- 对项目的全面控制 - ✅
read:org- 读取组织和团队成员身份
- ✅
- 生成令牌并复制它
- 在安装应用程序时粘贴它(在deco中)
🌟 主要特点
这个MCP服务器提供了强大的GitHub管理功能:
- 📊 项目V2管理使用GraphQL API对GitHub Projects V2执行完整的CRUD操作
- 🎯 完全问题控制创建、更新、关闭、标记、分配和评论问题
- 📝 数据库追踪跟踪特定的存储库和项目以进行重点监控
- 🤖 人工智能原生工具所有操作均以MCP工具的形式暴露,用于AI代理自动化
- **🔍 工具内省(或工具自检)**内置用户界面,用于探索所有可用工具及其架构
- ⚡ 实时更新通过直观的网页界面管理跟踪的仓库和项目
🎯 你可以做的事
使用这个MCP服务器,您可以:
- 自动化任务创建让AI根据需求创建并整理问题
- 智能项目管理人工智能可以管理项目看板并跟踪进度
- 智能标注根据内容自动对问题进行分类和标记
- 团队协作以编程方式分配问题并管理工作流程
- 状态追踪监控跨存储库的项目健康状况和问题状态
🎨 可用视图
安装该应用程序后,您将在deco工作区中访问这些视图:
- 📊 项目浏览器 - 浏览来自任何组织的GitHub项目V2
- 🐛 问题浏览器 - 详细探索问题,包括详细信息、评论和标签
- 📌 跟踪管理器 - 配置要监控的仓库和项目
- 🔧 工具检查器 - 探索所有25+种可用的MCP工具
📝 发展历程
这个仓库使用 “Specstory”可以翻译为“规格故事”或“特殊故事”,具体取决于上下文和语境。如果“Spec”指的是某种特定的规格、标准或特性,那么“规格故事”可能更贴切;如果“Spec”只是泛指某种特殊或独特的性质,那么“特殊故事”可能更合适。在没有具体上下文的情况下,两种翻译都可以接受 追踪……的历史
用于为这个仓库编码的提示。你可以查看完整的
在……的发展历程中 .specstory/ 文件夹。
✨ 模板特性
- 🤖 MCP服务器基于Cloudflare Workers的服务器,配备类型化AI工具
- ⚛️ React 前端使用Vite、TanStack Router和Tailwind CSS构建的现代React应用
- 🎨 用户界面组件预配置的 shadcn/ui 组件,用于快速开发
- 🔧 类型安全提供完整的TypeScript支持,并自动生成RPC客户端类型
- 🚀 热重载实时开发,前端和后端自动重建
- ☁️ 准备部署一键部署到Cloudflare Workers
- 🔗 API 集成通过Deco市场连接数千种服务
- 🛡️ 内置认证与流行提供商(如Google、GitHub等)的OAuth集成
- 🗄️ 集成数据库每个项目都包含一个带有10GB存储空间的SQLite数据库
🚧 即将推出:可视化工作流编辑器
我们正在完成我们的 可视化工作流编辑器 在那里,你将能够:
- 🎨 拖放通过直观的界面,以可视化方式构建AI工具
- 🤝 实时协作与您的团队一起协作处理工作流程
- 🧠 人工智能生成的工作流程让AI帮助您构建复杂的自动化流程
- ⚡ 实时预览在构建工作流的过程中,实时查看其运行情况
这将彻底改变您创建基于人工智能的自动化和数据处理流程的方式。
🚀 快速入门
创建AI应用程序的两种方法
选项1:使用npm create(推荐)
# Create a new AI app from this template
npm create deco@latest my-ai-app
# Navigate to your project
cd my-ai-app
# Configure your app (sets name, scope, and workspace)
npm run configure
# Start development server
npm run dev
选项2:使用GitHub模板
你也可以使用这个仓库作为GitHub模板来创建一个新的应用程序:
- 在GitHub上点击“使用此模板”以创建一个新仓库
- 克隆你的新仓库
- 安装依赖项并进行配置:
git clone <your-new-repo-url>
cd <your-new-repo>
# Install dependencies
npm install
# Configure your app (REQUIRED - sets name, scope, and workspace)
npm run configure
# Start development server
npm run dev
服务器将在 http://localhost:8787 同时为您的MCP终端和React前端提供服务。
先决条件
- Node.js ≥22.0.0
- Deco CLI(Deco 命令行界面) - 开发和部署所需:
npm install -g deco-cli - “Deco Account”可以翻译为“装饰账户”或“设计账户”,具体取决于上下文中的“Deco”是指装饰(Decoration)还是设计(Design)的缩写。在没有具体上下文的情况下,两种翻译都是合理的 - 在……注册 admin.decocms.com 翻译为中文可以是:“decocms.com的管理后台” 或者 “decocms.com的管理员网站”。这里,“admin”通常代表“administration”(管理)的意思,所以整个域名可以理解为是用于管理或管理员操作的网站部分
⚠️ 重要的设置注意事项
创建您的应用程序后(通过npm create或GitHub模板),您必须:
-
全局安装Deco CLI:
npm install -g deco-cli -
登录到Deco:
deco login -
配置您的应用程序 (首次使用前必做):
npm run configure这配置为:
- 应用名称确定您的部署URL
<app-name>.deco.page) - 范围映射到您的装饰组织/项目
- 工作区映射到您的Deco组织/项目
- 应用名称确定您的部署URL
-
部署 启用OAuth认证:
npm run deploy
注该模板带有默认值(name = "deco-create", scope = "kmute")。 你必须跑 npm run configure 在开发或部署之前,设置您自己的值。
📁 项目结构
├── server/ # MCP Server (Cloudflare Workers + Deco runtime)
│ ├── main.ts # Server entry point with AI tools
│ ├── tools/ # Domain-organized AI tools
│ └── deco.gen.ts # Auto-generated integration types
└── view/ # React Frontend (Vite + Tailwind CSS)
├── src/
│ ├── lib/rpc.ts # Typed RPC client for server communication
│ ├── routes/ # TanStack Router routes
│ └── components/ # UI components with Tailwind CSS
└── package.json
🛠️ 开发命令
npm run dev- 开始开发,启用热重载npm run gen- 为外部集成生成类型npm run deploy- 部署到生产环境npm run configure- 配置您的应用程序和工作区
🔗 前端 ↔ 服务器通信
该模板包含一个完全类型化的RPC客户端,用于将您的React前端与MCP服务器连接起来:
// Typed calls to your AI tools
const result = await client.MY_AI_TOOL({ input: "data" });
const analysis = await client.ANALYZE_DATA({ dataset: data });
🌐 API集成系统
通过您的助手,瞬间连接到数千项服务 装饰项目:
- 🤖 人工智能服务OpenAI、Anthropic、Cohere、本地模型
- 💳 支付Stripe,PayPal,Square
- 📧 通信SendGrid、Twilio、Slack
- 🗄️ 数据库PostgreSQL、MongoDB、Redis、Supabase
- 📊 分析Google Analytics(谷歌分析)、Mixpanel、Segment
- 还有成千上万的(例子/情况)。。。
添加集成
您设备上安装的所有应用程序 装饰项目 可以用来创建新的工具或视图:
- 安装应用程序 在您的装饰项目仪表盘中
- 运行集成:
npm run configure或者bun run configure - 自动生成的类型MCP类型被下载到
shared/deco.gen.ts - 开始构建立即在您的工具中使用已输入的客户端
所有集成都附带自动生成的 TypeScript 类型和零配置设置。
🗄️ 集成数据库
每个装饰项目都包含一个 带有10GB存储空间的SQLite数据库:
- 零设置数据库开箱即用
- **类型安全的ORM(对象关系映射)**内置支持TypeScript的Drizzle ORM
- 自动迁移模式更改会自动应用
- 已准备好投入生产根据您的应用需求进行扩展
非常适合在无需外部数据库设置的情况下存储用户数据、应用程序状态和业务逻辑。
🎯 示例用例
构建强大的AI应用,例如:
- 📊 数据分析工具连接数据库和API,利用AI分析业务数据
- 🤖 客户支持机器人与CRM(客户关系管理)系统和支持系统集成,提供智能辅助功能
- 📝 内容创作将人工智能与内容管理系统和社交媒体API相结合
- 💼 业务自动化创建连接多个服务并自动执行任务的工作流
- 🔍 研究助理构建能够从多个来源收集和分析信息的工具
- 📈 分析仪表板从您的业务数据中创建AI驱动的洞察
📖 资源
- 🚀 开始使用: 创建你的第一个AI应用
- 📚 文档说明: docs.deco.page 翻译为中文是:“文档装饰页面”(注:这里的“deco”可能是一个特定上下文或品牌中的缩写,直接翻译为“装饰”可能不完全准确,具体含义需结合上下文理解)。不过,如果“docs.deco.page”是一个特定网站或服务的名称,那么直接翻译可能无法完全传达其原意,建议保留原名称或根据具体上下文进行适当调整
- 💬 社区: 加入我们的Discord
- 🐙 源代码: deco-cx/deco(可翻译为“装饰-cx/装饰”,但具体翻译可能需根据上下文调整,因为“deco-cx”可能是一个特定产品、项目或技术的名称,没有统一的中文对应)
💡 开发小贴士
考虑使用 “SpecStory”可以翻译为“特殊故事”或“专题故事”,具体取决于上下文和语境。如果是指某个特定领域或主题的故事,也可以翻译为“专题报道”或“专项故事” 在您的AI编辑器中,可以追踪您在构建AI应用程序过程中的开发历史和提示。这是记录开发过程并与团队共享知识的绝佳方式。
准备好构建下一代人工智能应用了吗?
🚀 火箭或快速前进的象征(通常用于表达快速、进步或创新) 立即开始建造 • 📖 书籍或阅读的象征 阅读文档 • 💬 加入社区
