convez.ai
MCP ServerIntegração & APIsIntermediário
afine907

Agent Kit Admin

afine907/agent-kit-admin

Registro privado de MCP servers e Agent Skills com versionamento

Ver no GitHub
BomPluginScore · de 0 a 100

Plataforma de gerenciamento de pacotes privados para ecossistemas de agentes IA. Permite publicar, versionear e compartilhar Agent Skills entre membros da equipe, com suporte para CLI, Web UI e autenticação integrada.

Instalação

$npx convez-ai afine907/agent-kit-admin

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
100%
Último commit
há 2 meses
Versão
—
Issues abertas
9
Contribuidores
2

Casos de uso

  • Compartilhar Agent Skills reutilizáveis entre membros da equipe
  • Gerenciar versões de skills privados para Claude Code e Cursor
  • Centralizar e organizar ferramentas customizadas do ecossistema de agentes

Veredito

Solução robusta para empresas que precisam gerenciar um acervo interno de skills e MCP servers. Oferece CLI, Web UI e autenticação nativa, mas requer setup com Docker/Python e é voltada para contextos com múltiplos usuários.

README

A tradução para o português deste README ainda está na fila.

Agent Kit Admin

团队 AI 工具包管理平台 — 团队共享 Agent Skills,支持私有发布、版本管理、一键安装。

适用于:团队内部沉淀可复用的 Agent Skills,统一管理 Cursor/Claude Code 的 Agent Skills。

CI License: MIT


核心功能

功能说明
团队包管理发布、下载、版本控制团队私有的 Skill
Agent Skill发布可被 Agent 调用的 Skill 配置
CLI 工具akit 命令行,无缝集成到 Cursor/Claude Code
Web UI可视化包浏览、团队管理、安装追踪
本地认证邮箱密码注册登录 + API Key 认证

快速开始

1. 安装 CLI

npm install -g akit
# 或
pnpm add -g akit

2. 启动服务(Docker)

git clone https://github.com/afine907/agent-kit-admin.git
cd agent-kit-admin
cp apps/server/.env.example apps/server/.env  # 编辑配置
docker compose up -d

服务启动后访问 http://localhost:3000

3. 本地开发模式

# 终端 1: 启动 API
cd apps/server
cp .env.example .env
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -e ".[dev]"
uvicorn app.main:app --reload --port 8000

# 终端 2: 启动 Web
cd apps/web
pnpm install
pnpm dev

# 终端 3: 启动 CLI(开发模式)
cd apps/cli
pnpm install
pnpm link --global
akit --version

4. 登录并发布团队包

# 注册账号
akit register --email you@team.com --password ***

# 登录
akit login --email you@team.com --password ***

# 创建团队
curl -X POST http://localhost:8000/api/v1/teams \
  -H "Authorization: Bearer $(cat ~/.config/akit-nodejs/config.json | jq -r .token)" \
  -H "Content-Type: application/json" \
  -d '{"name":"My Team","slug":"myteam","description":"Internal tools"}'

# 初始化包
mkdir my-skill && cd my-skill
akit init

# 发布到团队
akit publish --team @myteam

CLI 命令

akit --version          # 查看版本
akit login              # 登录
akit register           # 注册
akit logout             # 登出
akit whoami             # 查看当前用户

akit list               # 列出已安装的包
akit list --team @myteam  # 列出团队包

akit install @scope/name    # 安装包
akit install @myteam/web-search  # 安装团队包

akit publish --team @myteam  # 发布到团队
akit publish .               # 发布个人包

akit search skill            # 搜索包
akit info @scope/name        # 查看包详情

akit update                  # 更新所有已安装的包
akit uninstall @scope/name   # 卸载包

团队包 vs 个人包

团队包个人包
可见范围团队成员所有人
发布方式akit publish --team @slugakit publish .
安装akit install @team/nameakit install @user/name
管理Web UI 团队页面Web UI 个人页面

团队包的命名规范:@{team-slug}/{package-name}


技术架构

┌─────────────────────────────────────────────┐
│              Web UI (React + Vite)           │
│   http://localhost:3000                      │
│   团队页面 / 包浏览 / 安装追踪                │
└────────────────────┬────────────────────────┘
                     │ REST API
┌────────────────────▼────────────────────────┐
│              API Server (FastAPI)           │
│   http://localhost:8000                      │
│   /api/v1/packages  包管理                   │
│   /api/v1/teams     团队管理                │
│   /api/v1/auth      认证                    │
└──────┬─────────────────┬───────────────────┘
       │                 │
┌──────▼──────┐   ┌─────▼──────┐
│  PostgreSQL  │   │    MinIO    │
│   包/用户    │   │   tarball   │
│   团队数据   │   │   存储      │
└─────────────┘   └────────────┘

开发指南

运行测试

# Server 测试
cd apps/server
pytest -q

# CLI 测试
cd apps/cli
pnpm test

# Web 测试
cd apps/web
pnpm test

代码规范

# Server
cd apps/server && ruff check . && ruff format --check .

# CLI
cd apps/cli && pnpm lint && pnpm typecheck

# Web
cd apps/web && pnpm lint && pnpm typecheck

配置

环境变量 (apps/server/.env)

DB_HOST=localhost
DB_PORT=5432
DB_USER=agentkit
DB_PASSWORD=agentkit_dev_2024
DB_NAME=agentkit

MINIO_ENDPOINT=localhost:9000
MINIO_ROOT_USER=minioadmin
MINIO_ROOT_PASSWORD=minioadmin_dev_2024
MINIO_BUCKET=packages

JWT_SECRET=your-secret-key
CORS_ORIGINS=["http://localhost:5173","http://localhost:3000"]

API 地址

CLI 默认连接 http://localhost:8000,可通过以下方式覆盖:

akit config set registry https://your-registry.com
# 或环境变量
AKIT_SERVER=https://your-registry.com akit list

贡献指南

欢迎提交 Issue 和 PR!请参阅 CONTRIBUTING.md 了解贡献流程。


License

MIT

Ver o original no GitHub

Bom para

Relacionados