Forja MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
🔨 Forja
Forje seu fluxo de trabalho de engenharia. Companion do Claude Code: agents, skills e scripts orquestrados, expostos via MCP.
Jira · Análise de repositórios · Padrões de commit/PR/DevOps · Relatórios · Slides & infográficos · RAG sobre a base de conhecimento
O que é
Forja é uma plataforma modular que reúne vários agents especializados (baseados no Claude Agent SDK), skills reutilizáveis e scripts. Ele foi pensado como uma ferramenta auxiliar ao Claude Code (e similares — Cursor, Claude Desktop): expõe os agents como tools MCP que você aciona de dentro da sua sessão de código. Há também uma interface web (FastAPI + dashboard) como cockpit local opcional e um CLI.
MCP server (principal) — os agents viram tools no Claude Code/Cursor/Claude Desktop. Veja
docs/mcp.md.Dashboard web (cockpit) — executar agents por clique e revisar resultados/artefatos.
CLI —
forja run <agent>para automações.
Agents / módulos
Módulo | Papel |
Jira | Analisar e controlar tasks no Jira (via MCP Atlassian): status, backlog, triagem, resumos. |
Repo Analysis | Varrer e analisar os diversos repositórios de serviços/projetos: saúde, dependências, convenções, débitos. |
Commit / PR / DevOps | Gerar bons padrões de commit (Conventional Commits), descrições de PR e práticas de DevOps/CI. |
Reports | Montar relatórios (status, sprint, incidentes) a partir de dados do Jira, dos repos e do RAG. |
Slides & Infographics | Conectar ao NotebookLM para gerar slides e infográficos a partir dos relatórios/base. |
RAG | Busca semântica sobre a base de documentos e |
Tudo é exposto por um dashboard web e por uma API que orquestra os agents.
Related MCP server: Snippy MCP Server
Arquitetura (visão rápida)
┌──────────────────────────────────────────────────────────┐
│ Web Dashboard + API (FastAPI) │
└───────────────┬──────────────────────────────────────────┘
│
┌───────▼────────┐ registry + runtime
│ Orchestrator │ ── Claude Agent SDK ──┐
└───────┬────────┘ │
┌────────────┼───────────────┬──────────┬──────┴──────┐
┌──▼──┐ ┌─────▼─────┐ ┌──────▼─────┐ ┌──▼────┐ ┌─────▼─────┐
│Jira │ │Repo Anal. │ │Commit/PR/ │ │Reports│ │Slides/ │
│agent│ │ agent │ │DevOps agent│ │ agent │ │Infographic│
└──┬──┘ └─────┬─────┘ └──────┬─────┘ └──┬────┘ └─────┬─────┘
│ │ │ │ │
┌──▼────────────▼────────────────▼──────────▼─────────────▼──┐
│ Integrations: Jira (MCP) · Git repos · NotebookLM │
│ RAG: embeddings (configurável) + vector store (Chroma) │
└─────────────────────────────────────────────────────────────┘Detalhes em docs/architecture.md.
Começando
# 1. Criar e ativar o ambiente
python -m venv .venv
# Windows (PowerShell): .venv\Scripts\Activate.ps1
# Linux/macOS: source .venv/bin/activate
# 2. Instalar em modo editável (dev)
pip install -e ".[dev]"
# 3. Configurar variáveis
cp .env.example .env # e preencha as chaves
# 4. Subir o dashboard
forja serve
# ou: uvicorn forja.web.app:app --reloadScripts de bootstrap prontos em scripts/ (bootstrap.ps1 / bootstrap.sh).
Usar com o Claude Code (MCP)
pip install -e ".[mcp]"
forja mcp # sobe o servidor MCP (stdio)Registre no Claude Code (copie .mcp.json.example para .mcp.json) ou:
claude mcp add forja -- ./.venv/Scripts/python.exe -m forja.mcp_serverOs agents ficam disponíveis como tools forja_jira, forja_rag, forja_reports, etc. Detalhes em docs/mcp.md.
Fluxo de desenvolvimento (Git Flow)
main— produção, sempre estável, com tags de release.develop— integração contínua das features.feature/*— uma funcionalidade por branch, PR paradevelop.release/*— estabilização, bump de versão e CHANGELOG, PR paramain+ tag.hotfix/*— correção urgente a partir demain.
Versionamento SemVer, histórico em CHANGELOG.md. Guia completo em docs/gitflow.md e helper em scripts/new_feature.sh.
Estrutura
src/forja/ código da plataforma (orchestrator, agents, rag, integrations, web)
knowledge_base/ documentos .md que alimentam o RAG
docs/ arquitetura, git flow e docs por agent
scripts/ bootstrap e helpers de git flow
tests/ testes (pytest)Licença
MIT.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Your org's AI agents, tasks, runs, search, and brain files as MCP tools and resources.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
One MCP endpoint for Claude, GPT & Gemini: 100+ tools + no-code connectors + agent workers.
An agent-first office suite Claude & ChatGPT read and write over one MCP URL.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceExposes AI agents as MCP tools to fetch Jira stories, generate BRDs and Playwright test scripts, run tests, and auto-heal broken locators. Integrates with Claude Desktop and Cursor IDE for enterprise-grade test automation.-
- FlicenseNot gradedqualityAmaintenanceEnables AI assistants to save and retrieve code snippets, perform semantic vector search, generate code style guides and wiki documentation, and orchestrate multi-agent workflows through MCP tools.-
- AlicenseBqualityCmaintenanceEnables AI agents to interact with Jira and GitHub through MCP tools, including searching, creating, commenting on, and transitioning Jira issues and listing pull requests, summarizing diffs, creating issues, and commenting on GitHub.8MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to perform software development tasks such as codebase analysis, research, planning, requirements and user-story generation, task management, project scaffolding, and multi-step workflow execution. It integrates with MCP-compatible clients like Claude Desktop, Cursor, and Cline AI.69 npmMIT