Itx-Psycho0/knative-func-agentic-poc

# Knative Functions: 端到端代理式工作流 [](https://github.com/Itx-Psycho0/knative-func-agentic-poc/actions) [](https://opensource.org/licenses/Apache-2.0) [](https://github.com/knative/func/issues/3646) ## 🎯 概述 本项目扩展了 Knative Functions 的 MCP (Model Context Protocol) 服务器，使 AI 代理能够自主管理无服务器函数的完整生命周期——从环境验证到 CI/CD 集成和生产部署。 ## 🚀 快速开始 ### 前置条件 - Go 1.21 或更高版本 - Docker Desktop（可选但推荐） - kubectl（可选，用于集群测试） ### 安装说明 ``` # 克隆仓库 git clone https://github.com/Itx-Psycho0/knative-func-agentic-poc.git cd knative-func-agentic-poc # 安装依赖项 go mod download # 构建项目 make build # 运行测试 make test ``` ## 🏗️ 架构 ``` ┌─────────────────────────────────────────────────────────────┐ │ AI Agent (Claude, etc.) │ └────────────────────────┬────────────────────────────────────┘ │ MCP Protocol ┌────────────────────────▼────────────────────────────────────┐ │ MCP Server (This POC) │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │ │ Prerequisite │ │ CI/CD │ │ Workflow │ │ │ │ Checking │ │ Integration │ │ Orchestration│ │ │ └──────────────┘ └──────────────┘ └──────────────┘ │ └────────────────────────┬────────────────────────────────────┘ │ ┌────────────────────────▼────────────────────────────────────┐ │ Knative Functions CLI │ └────────────────────────┬────────────────────────────────────┘ │ ┌────────────────────────▼────────────────────────────────────┐ │ Kubernetes Cluster (Knative) │ └─────────────────────────────────────────────────────────────┘ ``` ## 🛠️ MCP 工具（规划中） ### 前置条件检查 - `check_prerequisites` - 全面环境验证 - `validate_cluster` - Kubernetes 集群健康检查 - `suggest_remediation` - 检查失败的修复建议 ### CI/CD 集成 - `generate_github_workflow` - 创建 GitHub Actions 工作流 - `generate_gitlab_ci` - 创建 GitLab CI 流水线 - `setup_tekton_pipeline` - 创建 Tekton 流水线 - `configure_gitops` - 设置 ArgoCD/Flux 部署 ### 工作流编排 - `start_guided_workflow` - 开始引导式工作流 - `get_workflow_status` - 检查工作流进度 - `get_next_steps` - 获取下一步建议操作 ## 📊 项目状态 ### 已完成 ✅ - [x] 项目基础与结构 - [x] 基于 Cobra 的 CLI 框架 - [x] 前置条件检查框架 - [x] Docker 可用性检查器 - [x] 构建系统与 Makefile - [x] CI/CD 流水线（GitHub Actions） - [x] 全面的文档 ### 进行中 🚧 - [ ] Kubernetes 集群检查器 - [ ] 运行时依赖检查器 - [ ] MCP 服务器实现 - [ ] GitHub Actions 生成器 - [ ] 教学技能文档 ### 计划中 📋 - [ ] GitLab CI 生成器 - [ ] Tekton 流水线集成 - [ ] 工作流编排 - [ ] 完整的测试覆盖 - [ ] 演示场景 ## 🧪 测试 ``` # 运行单元测试 make test # 运行 coverage make test-coverage # 运行 linting make lint # 运行所有检查 make check ``` ## 📖 文档 - **架构**: 请参阅 [ARCHITECTURE.md](docs/ARCHITECTURE.md) （即将推出） - **贡献指南**: 请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) （即将推出） - **API 参考**: 请参阅 [API_REFERENCE.md](docs/API_REFERENCE.md) （即将推出） ## 🎓 教学方法 遵循维护者的愿景，本项目强调 **教学而非单纯自动化**： ### 渐进式复杂性级别 1. **初学者**：本地开发与基本概念 2. **中级**：GitHub Actions 与简单 CI/CD 3. **高级**：自托管运行器与本地集群 4. **专家**：Tekton 流水线与远程构建 5. **生产**：GitOps 与高级部署策略 ## 🤝 贡献指南 这是一个用于 LFX 导师计划提案的概念验证项目。欢迎提供反馈和建议！ 1. Fork 本仓库 2. 创建一个特性分支 (`git checkout -b feature/amazing-feature`) 3. 提交您的更改 (`git commit -m 'feat: add amazing feature'`) 4. 推送到该分支 (`git push origin feature/amazing-feature`) 5. 打开一个 Pull Request ## 📝 许可证 本项目采用 Apache License 2.0 授权 - 详情请见 [LICENSE](LICENSE) 文件。 ## 🙏 致谢 - **Knative 社区** - 为出色的 Knative Functions 项目 - **Anthropic** - 为 Model Context Protocol 规范 - **CNCF** - 为 LFX 导师计划 - **Luke Kingland** - 为项目范围提供的指导和反馈 ## 📧 联系方式 - **GitHub**: [@Itx-Psycho0](https://github.com/Itx-Psycho0) - **项目链接**: [https://github.com/Itx-Psycho0/knative-func-agentic-poc](https://github.com/Itx-Psycho0/knative-func-agentic-poc) - **LFX Issue**: [knative/func#3646](https://github.com/knative/func/issues/3646) ## 🎯 LFX 2026 提案 本概念验证展示了： 1. **技术能力**：深入理解 Go、Kubernetes、MCP 和 Knative 2. **解决问题能力**：针对实际开发者挑战的实用解决方案 3. **沟通能力**：清晰的文档和演示 4. **主动性**：超越基本要求的主动实现 5. **社区契合度**：遵循 Knative 项目惯例和维护者反馈 **为 Knative 社区用心打造 ❤️** *这是一个针对 LFX 2026 导师计划的概念验证项目*

标签：2026提案, AI代理, Docker, EVTX分析, GitHub Actions, Go语言, Knative, kubectl, LFX导师项目, MCP协议, Tekton, 子域名突变, 安全防御评估, 无服务器计算, 日志审计, 特权提升, 环境验证, 生命周期管理, 程序破解, 端到端工作流, 自动化部署, 自动笔记, 请求拦截