GitHub项目管理工具

一个AI驱动的GitHub Projects V2和问题管理工具,提供智能自动化功能,帮助团队自动化GitHub工作流程,包括任务管理、问题跟踪和项目组织。

  • by deco-cx
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 deco-cx/github-projects-mcp

使用说明

GitHub 项目管理器

基于AI的GitHub项目V2及智能自动化问题管理。

🔗(此符号在中文中无直接对应含义,通常用于表示链接或连接,在此处可保留原样或根据上下文解释为“链接”或“连接”) 应用URLhttps://github-projects.deco.page/(这个网址本身在中文中不直接翻译,但可以说明其含义为:一个展示GitHub项目的网页或平台,具体名称或功能需根据实际内容确定)

一个全面的MCP(模型上下文协议)服务器,用于通过人工智能管理GitHub项目V2和问题。专为希望实现GitHub工作流程自动化的团队而设计,具备智能任务管理、问题追踪和项目组织功能。

🚀 快速入门

安装

  1. 前往您的Deco工作区 在 admin.decocms.com 翻译为中文是:“Decocms 管理后台(或管理员控制台)”。这里,“admin”通常代表“管理员”或“管理后台”,“decocms.com”是网站或平台的域名,表示这是一个与 Decocms 相关的管理界面或控制台
  2. 导航至应用 在你的项目中
  3. 搜索“GitHub 项目管理器” 或者直接从以下位置安装:
    • 应用网址: https://github-projects.deco.page/
  4. 安装期间进行配置:
    • GitHub 令牌 (必需):具有(所需权限的)个人访问令牌 repo, project,以及 read:org 范围(或领域)
    • 默认组织 (可选):您的主要GitHub组织(例如。, deco-cx)

创建GitHub令牌

  1. 前往 GitHub 设置 → 开发者设置 → 个人访问令牌 → 代币(经典版)
  2. 点击“生成新令牌(经典版)”
  3. 选择范围:
    • ✅ repo - 完全控制私有仓库
    • ✅ 翻译为中文是:✅(这个符号本身在中文中通常不直接翻译,而是保留原样使用,表示“正确”或“确认”的意思。)如果非要给出一个解释性的翻译,可以是“正确/确认”。 project - 对项目的全面控制
    • ✅ read:org - 读取组织和团队成员身份
  4. 生成令牌并复制它
  5. 在安装应用程序时粘贴它(在deco中)

🌟 主要特点

这个MCP服务器提供了强大的GitHub管理功能:

  • 📊 项目V2管理使用GraphQL API对GitHub Projects V2执行完整的CRUD操作
  • 🎯 完全问题控制创建、更新、关闭、标记、分配和评论问题
  • 📝 数据库追踪跟踪特定的存储库和项目以进行重点监控
  • 🤖 人工智能原生工具所有操作均以MCP工具的形式暴露,用于AI代理自动化
  • **🔍 工具内省(或工具自检)**内置用户界面,用于探索所有可用工具及其架构
  • ⚡ 实时更新通过直观的网页界面管理跟踪的仓库和项目

🎯 你可以做的事

使用这个MCP服务器,您可以:

  • 自动化任务创建让AI根据需求创建并整理问题
  • 智能项目管理人工智能可以管理项目看板并跟踪进度
  • 智能标注根据内容自动对问题进行分类和标记
  • 团队协作以编程方式分配问题并管理工作流程
  • 状态追踪监控跨存储库的项目健康状况和问题状态

🎨 可用视图

安装该应用程序后,您将在deco工作区中访问这些视图:

  1. 📊 项目浏览器 - 浏览来自任何组织的GitHub项目V2
  2. 🐛 问题浏览器 - 详细探索问题,包括详细信息、评论和标签
  3. 📌 跟踪管理器 - 配置要监控的仓库和项目
  4. 🔧 工具检查器 - 探索所有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模板来创建一个新的应用程序:

  1. 在GitHub上点击“使用此模板”以创建一个新仓库
  2. 克隆你的新仓库
  3. 安装依赖项并进行配置:
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前端提供服务。

先决条件

⚠️ 重要的设置注意事项

创建您的应用程序后(通过npm create或GitHub模板),您必须:

  1. 全局安装Deco CLI:

    npm install -g deco-cli
    
  2. 登录到Deco:

    deco login
    
  3. 配置您的应用程序 (首次使用前必做):

    npm run configure
    

    这配置为:

    • 应用名称确定您的部署URL<app-name>.deco.page)
    • 范围映射到您的装饰组织/项目
    • 工作区映射到您的Deco组织/项目
  4. 部署 启用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
  • 还有成千上万的(例子/情况)。。。

添加集成

您设备上安装的所有应用程序 装饰项目 可以用来创建新的工具或视图:

  1. 安装应用程序 在您的装饰项目仪表盘中
  2. 运行集成: npm run configure 或者 bun run configure
  3. 自动生成的类型MCP类型被下载到 shared/deco.gen.ts
  4. 开始构建立即在您的工具中使用已输入的客户端

所有集成都附带自动生成的 TypeScript 类型和零配置设置。

🗄️ 集成数据库

每个装饰项目都包含一个 带有10GB存储空间的SQLite数据库:

  • 零设置数据库开箱即用
  • **类型安全的ORM(对象关系映射)**内置支持TypeScript的Drizzle ORM
  • 自动迁移模式更改会自动应用
  • 已准备好投入生产根据您的应用需求进行扩展

非常适合在无需外部数据库设置的情况下存储用户数据、应用程序状态和业务逻辑。

🎯 示例用例

构建强大的AI应用,例如:

  • 📊 数据分析工具连接数据库和API,利用AI分析业务数据
  • 🤖 客户支持机器人与CRM(客户关系管理)系统和支持系统集成,提供智能辅助功能
  • 📝 内容创作将人工智能与内容管理系统和社交媒体API相结合
  • 💼 业务自动化创建连接多个服务并自动执行任务的工作流
  • 🔍 研究助理构建能够从多个来源收集和分析信息的工具
  • 📈 分析仪表板从您的业务数据中创建AI驱动的洞察

📖 资源

💡 开发小贴士

考虑使用 “SpecStory”可以翻译为“特殊故事”或“专题故事”,具体取决于上下文和语境。如果是指某个特定领域或主题的故事,也可以翻译为“专题报道”或“专项故事” 在您的AI编辑器中,可以追踪您在构建AI应用程序过程中的开发历史和提示。这是记录开发过程并与团队共享知识的绝佳方式。


准备好构建下一代人工智能应用了吗?

🚀 火箭或快速前进的象征(通常用于表达快速、进步或创新) 立即开始建造 • 📖 书籍或阅读的象征 阅读文档 • 💬 加入社区