An open API service indexing awesome lists of open source software.

https://github.com/br-silvano/mcp-todo

API de gerenciamento de tarefas via WebSocket com execução modular de comandos e suporte a ferramentas, desenvolvida em TypeScript com banco SQLite. Projetada para integração com agentes de inteligência artificial.
https://github.com/br-silvano/mcp-todo

agent agentic-ai ai ajv api command-pattern eslint jest mcp mcp-server modular-architecture sqlite task-manager todo tool tools typescript use-tool websocket zod

Last synced: about 2 months ago
JSON representation

API de gerenciamento de tarefas via WebSocket com execução modular de comandos e suporte a ferramentas, desenvolvida em TypeScript com banco SQLite. Projetada para integração com agentes de inteligência artificial.

Awesome Lists containing this project

README

          

## 🧱 MCP Todo

[![Build and Test](https://github.com/br-silvano/mcp-todo/actions/workflows/build.yml/badge.svg)](https://github.com/br-silvano/mcp-todo/actions/workflows/build.yml)

> API de gerenciamento de tarefas via WebSocket com execução modular de comandos e suporte a ferramentas, desenvolvida em TypeScript com banco SQLite. Projetada para integração com agentes de inteligência artificial.

---

### ▶️ Executar o Projeto

1. **Garantir permissão de execução no hook de commit (Husky):**

```bash
chmod +x .husky/pre-commit
```

> Isso garante que o hook de `pre-commit` seja executado corretamente ao tentar fazer um `git commit`.

2. **Iniciar o servidor de desenvolvimento:**

```bash
npm run dev
```

> Executa o servidor via `ts-node`.

3. **Verificar se o repositório Git está corretamente inicializado:**

```bash
git rev-parse --is-inside-work-tree
```

> Útil para validar que o diretório está dentro de um repositório Git — necessário para o funcionamento de ferramentas como Husky e lint-staged.

---

### 🧪 Executar os Testes

```bash
npm run test
```

> Roda a suíte de testes configurada com Jest.

---

### 📌 Requisitos

Antes de rodar os comandos acima, certifique-se de que possui os seguintes requisitos instalados:

- [Node.js](https://nodejs.org/) v20 ou superior
- [npm](https://www.npmjs.com/) v10 ou superior
- Git

---

### 🛠️ Scripts disponíveis

- `npm run dev`: inicia a aplicação em modo de desenvolvimento com suporte a TypeScript
- `npm run test`: executa os testes com Jest
- `npm run lint`: roda o ESLint para análise de código

---

### 📋 Relatórios e Resultados

- **✅ Status do Build/Testes:** O status da última execução do workflow é exibido no topo do repositório via badge do GitHub Actions.
- **📦 Artifacts Disponíveis:**
- `build-artifact` (📁 `./dist`) – contém os arquivos gerados no processo de build.
- `coverage` (📁 `./coverage`) – relatório detalhado de cobertura de testes, com visualização em `coverage/lcov-report/index.html`.
- **🔗 Acesso aos Artifacts:** Os artifacts gerados estão disponíveis na [página de Actions](https://github.com/br-silvano/mcp-todo/actions).