@semacode/mcp 1.2.18 → 1.2.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/dist/index.js +74 -57
  2. package/package.json +2 -2
package/dist/index.js CHANGED
@@ -4,6 +4,7 @@ import { spawnSync } from "node:child_process";
4
4
  import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
5
5
  import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
6
6
  import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
7
+ import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
7
8
  import { z } from "zod";
8
9
  function chamarSema(args, cwd) {
9
10
  const resultado = spawnSync("sema", args, {
@@ -19,81 +20,75 @@ function chamarSema(args, cwd) {
19
20
  }
20
21
  return [saida, erro].filter(Boolean).join("\n");
21
22
  }
22
- const server = new McpServer({
23
- name: "sema",
24
- version: "1.2.17",
25
- });
26
- server.tool("sema_validar", "Valida um arquivo .sema e retorna diagnosticos de erro ou sucesso.", { arquivo: z.string().describe("Caminho absoluto ou relativo para o arquivo .sema") }, async ({ arquivo }) => ({
27
- content: [{ type: "text", text: chamarSema(["validar", arquivo]) }],
28
- }));
29
- server.tool("sema_ir", "Compila um arquivo .sema e retorna a representacao intermediaria (IR) em JSON.", { arquivo: z.string().describe("Caminho para o arquivo .sema") }, async ({ arquivo }) => ({
30
- content: [{ type: "text", text: chamarSema(["ir", arquivo, "--json"]) }],
31
- }));
32
- server.tool("sema_drift", "Analisa o drift entre o contrato .sema e o codigo do projeto. Retorna divergencias encontradas.", {
33
- projeto: z.string().optional().describe("Caminho do projeto (padrao: diretorio atual)"),
34
- json: z.boolean().optional().describe("Retornar saida em JSON"),
35
- }, async ({ projeto, json }) => {
36
- const args = ["drift", ...(projeto ? [projeto] : []), ...(json ? ["--json"] : [])];
37
- return { content: [{ type: "text", text: chamarSema(args, projeto) }] };
38
- });
39
- server.tool("sema_resumo", "Gera um resumo IA-first do projeto Sema com modulos, riscos e lacunas.", {
40
- projeto: z.string().optional().describe("Caminho do projeto (padrao: diretorio atual)"),
41
- tamanho: z
42
- .enum(["micro", "curto", "medio"])
43
- .optional()
44
- .describe("Tamanho do resumo (padrao: curto)"),
45
- }, async ({ projeto, tamanho }) => {
46
- const args = [
47
- "resumo",
48
- ...(tamanho ? [`--tamanho=${tamanho}`] : []),
49
- ];
50
- return { content: [{ type: "text", text: chamarSema(args, projeto) }] };
51
- });
52
- server.tool("sema_prompt_ia", "Gera o prompt-curto IA-first do projeto para briefar um agente sobre o estado atual.", { projeto: z.string().optional().describe("Caminho do projeto") }, async ({ projeto }) => ({
53
- content: [{ type: "text", text: chamarSema(["prompt-curto"], projeto) }],
54
- }));
55
- server.tool("sema_contexto_ia", "Gera o pacote completo de contexto IA para um modulo ou projeto (briefing, drift, IR, artefatos).", { arquivo: z.string().describe("Caminho para o arquivo .sema do modulo") }, async ({ arquivo }) => ({
56
- content: [{ type: "text", text: chamarSema(["contexto-ia", arquivo]) }],
57
- }));
58
- server.tool("sema_verificar", "Verifica todos os alvos de geracao de um projeto Sema (compila, gera e testa cada alvo).", {
59
- projeto: z.string().describe("Caminho do projeto a verificar"),
60
- saida: z.string().optional().describe("Pasta de saida dos artefatos gerados"),
61
- }, async ({ projeto, saida }) => {
62
- const args = ["verificar", projeto, ...(saida ? ["--saida", saida] : [])];
63
- return { content: [{ type: "text", text: chamarSema(args) }] };
64
- });
65
- server.tool("sema_inspecionar", "Inspeciona um arquivo .sema e mostra detalhes do modulo: rotas, tarefas, eventos, politicas.", { arquivo: z.string().describe("Caminho para o arquivo .sema") }, async ({ arquivo }) => ({
66
- content: [{ type: "text", text: chamarSema(["inspecionar", arquivo]) }],
67
- }));
23
+ function registrarFerramentas(s) {
24
+ s.tool("sema_validar", "Valida um arquivo .sema e retorna diagnosticos de erro ou sucesso.", { arquivo: z.string().describe("Caminho absoluto ou relativo para o arquivo .sema") }, async ({ arquivo }) => ({
25
+ content: [{ type: "text", text: chamarSema(["validar", arquivo]) }],
26
+ }));
27
+ s.tool("sema_ir", "Compila um arquivo .sema e retorna a representacao intermediaria (IR) em JSON.", { arquivo: z.string().describe("Caminho para o arquivo .sema") }, async ({ arquivo }) => ({
28
+ content: [{ type: "text", text: chamarSema(["ir", arquivo, "--json"]) }],
29
+ }));
30
+ s.tool("sema_drift", "Analisa o drift entre o contrato .sema e o codigo do projeto. Retorna divergencias encontradas.", {
31
+ projeto: z.string().optional().describe("Caminho do projeto (padrao: diretorio atual)"),
32
+ json: z.boolean().optional().describe("Retornar saida em JSON"),
33
+ }, async ({ projeto, json }) => {
34
+ const args = ["drift", ...(projeto ? [projeto] : []), ...(json ? ["--json"] : [])];
35
+ return { content: [{ type: "text", text: chamarSema(args, projeto) }] };
36
+ });
37
+ s.tool("sema_resumo", "Gera um resumo IA-first do projeto Sema com modulos, riscos e lacunas.", {
38
+ projeto: z.string().optional().describe("Caminho do projeto (padrao: diretorio atual)"),
39
+ tamanho: z.enum(["micro", "curto", "medio"]).optional().describe("Tamanho do resumo (padrao: curto)"),
40
+ }, async ({ projeto, tamanho }) => {
41
+ const args = ["resumo", ...(tamanho ? [`--tamanho=${tamanho}`] : [])];
42
+ return { content: [{ type: "text", text: chamarSema(args, projeto) }] };
43
+ });
44
+ s.tool("sema_prompt_ia", "Gera o prompt-curto IA-first do projeto para briefar um agente sobre o estado atual.", { projeto: z.string().optional().describe("Caminho do projeto") }, async ({ projeto }) => ({
45
+ content: [{ type: "text", text: chamarSema(["prompt-curto"], projeto) }],
46
+ }));
47
+ s.tool("sema_contexto_ia", "Gera o pacote completo de contexto IA para um modulo ou projeto (briefing, drift, IR, artefatos).", { arquivo: z.string().describe("Caminho para o arquivo .sema do modulo") }, async ({ arquivo }) => ({
48
+ content: [{ type: "text", text: chamarSema(["contexto-ia", arquivo]) }],
49
+ }));
50
+ s.tool("sema_verificar", "Verifica todos os alvos de geracao de um projeto Sema (compila, gera e testa cada alvo).", {
51
+ projeto: z.string().describe("Caminho do projeto a verificar"),
52
+ saida: z.string().optional().describe("Pasta de saida dos artefatos gerados"),
53
+ }, async ({ projeto, saida }) => {
54
+ const args = ["verificar", projeto, ...(saida ? ["--saida", saida] : [])];
55
+ return { content: [{ type: "text", text: chamarSema(args) }] };
56
+ });
57
+ s.tool("sema_inspecionar", "Inspeciona um arquivo .sema e mostra detalhes do modulo: rotas, tarefas, eventos, politicas.", { arquivo: z.string().describe("Caminho para o arquivo .sema") }, async ({ arquivo }) => ({
58
+ content: [{ type: "text", text: chamarSema(["inspecionar", arquivo]) }],
59
+ }));
60
+ }
68
61
  const porta = process.env["MCP_PORT"] ? parseInt(process.env["MCP_PORT"]) : null;
69
62
  if (porta) {
70
- // Modo Streamable HTTP — protocolo MCP moderno para acesso remoto
71
- const transportes = new Map();
63
+ // Modo HTTP remoto — suporta Streamable HTTP (/mcp) e SSE legado (/sse)
64
+ const httpTransportes = new Map();
65
+ const sseTransportes = new Map();
72
66
  const http = createServer(async (req, res) => {
73
67
  const url = req.url ?? "/";
68
+ // Streamable HTTP — protocolo MCP moderno
74
69
  if (url === "/mcp") {
75
70
  if (req.method === "POST") {
76
- // Sessao stateless ou nova sessao stateful
77
71
  const sessionId = req.headers["mcp-session-id"];
78
- let transport = sessionId ? transportes.get(sessionId) : undefined;
72
+ let transport = sessionId ? httpTransportes.get(sessionId) : undefined;
79
73
  if (!transport) {
80
- // Nova sessao
81
74
  transport = new StreamableHTTPServerTransport({
82
75
  sessionIdGenerator: () => crypto.randomUUID(),
83
- onsessioninitialized: (id) => { transportes.set(id, transport); },
76
+ onsessioninitialized: (id) => { httpTransportes.set(id, transport); },
84
77
  });
85
78
  transport.onclose = () => {
86
79
  if (transport.sessionId)
87
- transportes.delete(transport.sessionId);
80
+ httpTransportes.delete(transport.sessionId);
88
81
  };
89
- await server.connect(transport);
82
+ const s = new McpServer({ name: "sema", version: "1.2.18" });
83
+ registrarFerramentas(s);
84
+ await s.connect(transport);
90
85
  }
91
86
  await transport.handleRequest(req, res);
92
87
  return;
93
88
  }
94
89
  if (req.method === "GET" || req.method === "DELETE") {
95
90
  const sessionId = req.headers["mcp-session-id"];
96
- const transport = sessionId ? transportes.get(sessionId) : undefined;
91
+ const transport = sessionId ? httpTransportes.get(sessionId) : undefined;
97
92
  if (!transport) {
98
93
  res.writeHead(404).end("Sessao nao encontrada");
99
94
  return;
@@ -102,14 +97,36 @@ if (porta) {
102
97
  return;
103
98
  }
104
99
  }
100
+ // SSE legado — compatibilidade com GPT e clientes antigos
101
+ if (req.method === "GET" && url === "/sse") {
102
+ const sseTransport = new SSEServerTransport("/message", res);
103
+ sseTransportes.set(sseTransport.sessionId, sseTransport);
104
+ res.on("close", () => sseTransportes.delete(sseTransport.sessionId));
105
+ const s = new McpServer({ name: "sema", version: "1.2.18" });
106
+ registrarFerramentas(s);
107
+ await s.connect(sseTransport);
108
+ return;
109
+ }
110
+ if (req.method === "POST" && url.startsWith("/message")) {
111
+ const sessionId = new URL(url, "http://localhost").searchParams.get("sessionId") ?? "";
112
+ const sseTransport = sseTransportes.get(sessionId);
113
+ if (!sseTransport) {
114
+ res.writeHead(404).end("Sessao nao encontrada");
115
+ return;
116
+ }
117
+ await sseTransport.handlePostMessage(req, res);
118
+ return;
119
+ }
105
120
  res.writeHead(404).end();
106
121
  });
107
122
  http.listen(porta, () => {
108
- process.stderr.write(`sema-mcp rodando em HTTP na porta ${porta} (endpoint: /mcp)\n`);
123
+ process.stderr.write(`sema-mcp rodando na porta ${porta} (HTTP: /mcp | SSE: /sse)\n`);
109
124
  });
110
125
  }
111
126
  else {
112
- // Modo stdio — para uso local / Claude Code
127
+ // Modo stdio — uso local com Claude Code, Cursor, VS Code
128
+ const server = new McpServer({ name: "sema", version: "1.2.18" });
129
+ registrarFerramentas(server);
113
130
  const transport = new StdioServerTransport();
114
131
  await server.connect(transport);
115
132
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@semacode/mcp",
3
- "version": "1.2.18",
3
+ "version": "1.2.19",
4
4
  "type": "module",
5
5
  "description": "Servidor MCP da Sema — expoe validacao, drift e contexto IA como ferramentas para agentes.",
6
6
  "license": "MIT",
@@ -37,7 +37,7 @@
37
37
  "@modelcontextprotocol/sdk": "^1.10.1"
38
38
  },
39
39
  "devDependencies": {
40
- "@types/node": "^22.13.14",
40
+ "@types/node": "^22.19.17",
41
41
  "typescript": "^5.8.3"
42
42
  }
43
43
  }