@semacode/mcp 1.2.17 → 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 (8) hide show
  1. package/dist/index.js +74 -57
  2. package/package.json +2 -2
  3. package/.deploy/docker-compose.sema-mcp.yml +0 -11
  4. package/.deploy/sema-mcp-deploy.tar.gz +0 -0
  5. package/.deploy/semacode-cli-1.2.17.tgz +0 -0
  6. package/Dockerfile +0 -20
  7. package/src/index.ts +0 -173
  8. package/tsconfig.json +0 -9
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.17",
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
  }
package/.deploy/docker-compose.sema-mcp.yml DELETED
@@ -1,11 +0,0 @@
1
- services:
2
- sema-mcp:
3
- image: sema-mcp:latest
4
- container_name: sema-mcp
5
- restart: unless-stopped
6
- ports:
7
- - "3010:3010"
8
- environment:
9
- MCP_PORT: "3010"
10
- volumes:
11
- - /root/sema-mcp/projetos:/projetos:ro
package/.deploy/sema-mcp-deploy.tar.gz DELETED
Binary file
package/.deploy/semacode-cli-1.2.17.tgz DELETED
Binary file
package/Dockerfile DELETED
@@ -1,20 +0,0 @@
1
- FROM node:22-alpine
2
-
3
- WORKDIR /app
4
-
5
- # Instala a CLI da Sema a partir do pacote local empacotado
6
- COPY semacode-cli-1.2.17.tgz /tmp/semacode-cli.tgz
7
- RUN npm install -g /tmp/semacode-cli.tgz && rm /tmp/semacode-cli.tgz
8
-
9
- # Copia o servidor MCP ja compilado
10
- COPY dist/ ./dist/
11
- COPY package.json ./
12
-
13
- # Instala apenas as dependencias de producao do pacote mcp
14
- RUN npm install --omit=dev
15
-
16
- EXPOSE 3010
17
-
18
- ENV MCP_PORT=3010
19
-
20
- CMD ["node", "dist/index.js"]
package/src/index.ts DELETED
@@ -1,173 +0,0 @@
1
- #!/usr/bin/env node
2
- import { createServer, IncomingMessage, ServerResponse } from "node:http";
3
- import { spawnSync } from "node:child_process";
4
- import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
5
- import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
6
- import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
7
- import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
8
- import { z } from "zod";
9
-
10
- function chamarSema(args: string[], cwd?: string): string {
11
- const resultado = spawnSync("sema", args, {
12
- encoding: "utf-8",
13
- cwd: cwd ?? process.cwd(),
14
- env: process.env,
15
- shell: true,
16
- });
17
- const saida = (resultado.stdout ?? "").trim();
18
- const erro = (resultado.stderr ?? "").trim();
19
- if (resultado.error) {
20
- return `Erro ao chamar sema: ${resultado.error.message}`;
21
- }
22
- return [saida, erro].filter(Boolean).join("\n");
23
- }
24
-
25
- const server = new McpServer({
26
- name: "sema",
27
- version: "1.2.17",
28
- });
29
-
30
- server.tool(
31
- "sema_validar",
32
- "Valida um arquivo .sema e retorna diagnosticos de erro ou sucesso.",
33
- { arquivo: z.string().describe("Caminho absoluto ou relativo para o arquivo .sema") },
34
- async ({ arquivo }) => ({
35
- content: [{ type: "text", text: chamarSema(["validar", arquivo]) }],
36
- })
37
- );
38
-
39
- server.tool(
40
- "sema_ir",
41
- "Compila um arquivo .sema e retorna a representacao intermediaria (IR) em JSON.",
42
- { arquivo: z.string().describe("Caminho para o arquivo .sema") },
43
- async ({ arquivo }) => ({
44
- content: [{ type: "text", text: chamarSema(["ir", arquivo, "--json"]) }],
45
- })
46
- );
47
-
48
- server.tool(
49
- "sema_drift",
50
- "Analisa o drift entre o contrato .sema e o codigo do projeto. Retorna divergencias encontradas.",
51
- {
52
- projeto: z.string().optional().describe("Caminho do projeto (padrao: diretorio atual)"),
53
- json: z.boolean().optional().describe("Retornar saida em JSON"),
54
- },
55
- async ({ projeto, json }) => {
56
- const args = ["drift", ...(projeto ? [projeto] : []), ...(json ? ["--json"] : [])];
57
- return { content: [{ type: "text", text: chamarSema(args, projeto) }] };
58
- }
59
- );
60
-
61
- server.tool(
62
- "sema_resumo",
63
- "Gera um resumo IA-first do projeto Sema com modulos, riscos e lacunas.",
64
- {
65
- projeto: z.string().optional().describe("Caminho do projeto (padrao: diretorio atual)"),
66
- tamanho: z
67
- .enum(["micro", "curto", "medio"])
68
- .optional()
69
- .describe("Tamanho do resumo (padrao: curto)"),
70
- },
71
- async ({ projeto, tamanho }) => {
72
- const args = [
73
- "resumo",
74
- ...(tamanho ? [`--tamanho=${tamanho}`] : []),
75
- ];
76
- return { content: [{ type: "text", text: chamarSema(args, projeto) }] };
77
- }
78
- );
79
-
80
- server.tool(
81
- "sema_prompt_ia",
82
- "Gera o prompt-curto IA-first do projeto para briefar um agente sobre o estado atual.",
83
- { projeto: z.string().optional().describe("Caminho do projeto") },
84
- async ({ projeto }) => ({
85
- content: [{ type: "text", text: chamarSema(["prompt-curto"], projeto) }],
86
- })
87
- );
88
-
89
- server.tool(
90
- "sema_contexto_ia",
91
- "Gera o pacote completo de contexto IA para um modulo ou projeto (briefing, drift, IR, artefatos).",
92
- { arquivo: z.string().describe("Caminho para o arquivo .sema do modulo") },
93
- async ({ arquivo }) => ({
94
- content: [{ type: "text", text: chamarSema(["contexto-ia", arquivo]) }],
95
- })
96
- );
97
-
98
- server.tool(
99
- "sema_verificar",
100
- "Verifica todos os alvos de geracao de um projeto Sema (compila, gera e testa cada alvo).",
101
- {
102
- projeto: z.string().describe("Caminho do projeto a verificar"),
103
- saida: z.string().optional().describe("Pasta de saida dos artefatos gerados"),
104
- },
105
- async ({ projeto, saida }) => {
106
- const args = ["verificar", projeto, ...(saida ? ["--saida", saida] : [])];
107
- return { content: [{ type: "text", text: chamarSema(args) }] };
108
- }
109
- );
110
-
111
- server.tool(
112
- "sema_inspecionar",
113
- "Inspeciona um arquivo .sema e mostra detalhes do modulo: rotas, tarefas, eventos, politicas.",
114
- { arquivo: z.string().describe("Caminho para o arquivo .sema") },
115
- async ({ arquivo }) => ({
116
- content: [{ type: "text", text: chamarSema(["inspecionar", arquivo]) }],
117
- })
118
- );
119
-
120
- const porta = process.env["MCP_PORT"] ? parseInt(process.env["MCP_PORT"]) : null;
121
-
122
- if (porta) {
123
- // Modo Streamable HTTP — protocolo MCP moderno para acesso remoto
124
- const transportes = new Map<string, StreamableHTTPServerTransport>();
125
-
126
- const http = createServer(async (req: IncomingMessage, res: ServerResponse) => {
127
- const url = req.url ?? "/";
128
-
129
- if (url === "/mcp") {
130
- if (req.method === "POST") {
131
- // Sessao stateless ou nova sessao stateful
132
- const sessionId = req.headers["mcp-session-id"] as string | undefined;
133
- let transport = sessionId ? transportes.get(sessionId) : undefined;
134
-
135
- if (!transport) {
136
- // Nova sessao
137
- transport = new StreamableHTTPServerTransport({
138
- sessionIdGenerator: () => crypto.randomUUID(),
139
- onsessioninitialized: (id) => { transportes.set(id, transport!); },
140
- });
141
- transport.onclose = () => {
142
- if (transport!.sessionId) transportes.delete(transport!.sessionId);
143
- };
144
- await server.connect(transport);
145
- }
146
-
147
- await transport.handleRequest(req, res);
148
- return;
149
- }
150
-
151
- if (req.method === "GET" || req.method === "DELETE") {
152
- const sessionId = req.headers["mcp-session-id"] as string | undefined;
153
- const transport = sessionId ? transportes.get(sessionId) : undefined;
154
- if (!transport) {
155
- res.writeHead(404).end("Sessao nao encontrada");
156
- return;
157
- }
158
- await transport.handleRequest(req, res);
159
- return;
160
- }
161
- }
162
-
163
- res.writeHead(404).end();
164
- });
165
-
166
- http.listen(porta, () => {
167
- process.stderr.write(`sema-mcp rodando em HTTP na porta ${porta} (endpoint: /mcp)\n`);
168
- });
169
- } else {
170
- // Modo stdio — para uso local / Claude Code
171
- const transport = new StdioServerTransport();
172
- await server.connect(transport);
173
- }
package/tsconfig.json DELETED
@@ -1,9 +0,0 @@
1
- {
2
- "extends": "../../tsconfig.base.json",
3
- "compilerOptions": {
4
- "composite": true,
5
- "rootDir": "src",
6
- "outDir": "dist"
7
- },
8
- "include": ["src/**/*"]
9
- }