Coordination MCP

Coordination MCP es un servicio ligero de estado de trabajo compartido para múltiples participantes de IA. A través de MCP ofrece un Ticket persistente, un Update inmutable y un Artifact de texto, para que ChatGPT, la IA local y los agentes de codificación puedan compartir, sincronizar de forma incremental y restaurar el contexto de trabajo en un mismo Scope.

Lo que puede hacer V0.1

• Ticket: guarda el estado actual de un trabajo y permite actualizar title, status, artifact_ids y meta.

• Update: guarda hechos, hallazgos, decisiones o resultados que ya han ocurrido, y asigna un seq monótonamente creciente por Scope.

• Artifact: guarda contenido de texto compartido e inmutable, como Markdown, logs o documentos largos.

• Todos los objetos reciben un identificador único global asignado por el servidor.

• Las referencias de Ticket y Artifact deben pertenecer al mismo Scope.

V0.1 no incluye autenticación, motor de workflows, acuse de recibo de cola, grafo de relaciones, notificaciones de activación ni soporte de artefactos binarios.

Usos recomendados

• Ticket representa el estado variable actual de un trabajo en curso; no es un registro de eventos.

• Update representa eventos inmutables ya ocurridos en la línea de tiempo del trabajo, como request, finding, decision o result.

• Artifact representa contenido textual largo e inmutable; revisiones largas, especificaciones o logs deben guardarse en un Artifact, no dentro de un Update, y se relacionan mediante artifact_ids.

• created_by debe usar una etiqueta estable o para el participante, entre ejecuciones y agentes; por ejemplo, chatgpt, pi-local-agent. No uses un nombre source práctic. Ese campo es para traxión de origen, no para autentición.

Un ciclo de revisión típico es: la IA local solicita una revisión mediante un Update → ChatGPT guarda la revisión completa como un Artifact y devuelve un resumen y artifact_ids mediante moyen de un Update → la IA local correge el códigor y agrega un Update de resultado → ChatGPT vuelve a revisar.

Inicio rápido

Requisito: Node.js 24+.

cd /path/to/coordination-mcp
npm install
npm run build
node dist/main.js

El servico escucha por defecto en:

http://127.0.0.1:3000/mcp

También se puede ejecuencar la versión de desarro:

npm run dev

El servico solo se vincula a 127.0.0.1. Si se neesita el acers froma ChatGPT remoto, se deberá exponer el endpoint de MCP mediante un túnel seguro, no publicar el Node.js servico directamente a inet. V0.1 no tiene auth entificación por ahora.

Configuración

La prioridad de la configuración, de menos a más:

代码默认值 < config/default.yml < ~/.coordination-mcp/config.yml < --profile < 环境变量

Configuración del usuario

Crear la configuración del usuario:

mkdir -p ~/.coordination-mcp
$EDITOR ~/.coordination-mcp/config.yml

Ejemplo:

port: 43721
allowedHosts:
  - 127.0.0.1
  - localhost
# dataDirectory: /absolute/path/to/coordination-data

~/.coordination-mcp/config.yml es opcional y no se genera médio por the service. Cuando no se setea dataDirectory, se usa por defecto:

~/.coordination-mcp/data

Se recomanda escribir el dataDirectory como ruta absol. Las rutas relativa se resuelven relativas al current working directory en el arrancoe del proceso.

Profile

El path de profile se resolverá relativ to current working directory; when indicated the file must exist:

node dist/main.js --profile config/local.yml
node dist/main.js --profile=/absolute/path/to/local.yml

A profile only overrides the directory. Overrides field only; las not declaradas continue inheritance the previous configuration.

Variables de entorno

PORT=43721 \
COORDINATION_DATA_DIR=/absolute/path/to/data \
COORDINATION_ALLOWED_HOSTS=127.0.0.1,localhost \
node dist/main.js

Variables de entorno compatisles:

El archivo de configuración se lee solo al arrancar el servicio; después hay that restart main.js.

extTools MCP

El servicio expone las siguiente 8 herramientasiciones a través de POST /mcp:

Ejemplo de init of MCP

curl -N \
  -H 'Accept: application/json, text/event-stream' \
  -H 'Content-Type: application/json' \
  -H 'mcp-protocol-version: 2025-03-26' \
  -X POST http://127.0.0.1:3000/mcp \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": {
        "name": "manual-client",
        "version": "0.1.0"
      }
    }
  }'

Ejemplo de crear un Ticket

Ejemplo de parámetros para tools/call:

{
  "name": "create_ticket",
  "arguments": {
    "scope": "coordination-mcp",
    "title": "Review the MCP integration",
    "created_by": "local-ai",
    "status": "open",
    "meta": {
      "priority": "high"
    }
  }
}

Datos de almacenamiento

La ruta de datos default se creates on demande; alone al iniciar el servicio e read operations on demand can't create it. The first time you write a Ticket, an Update or an Artifact, a structure is created in the similar:

~/.coordination-mcp/
├── config.yml                 # 可选用户配置
└── data/
    └── scopes/
        └── <base64url-scope>/
            ├── tickets/
            │   └── T-*.json
            ├── updates.jsonl
            └── artifacts/
                └── A-*.json

• Tickets y Artefactos se almacen in separate JSON files pretty-print.

• The Updates of a Scope are stored in an append-only JSONL file; on reading, last damaged trailing record without a terminal newline and unable to parse is ignored, but JSON corruption in complete newline-terminated records is not hidden.

• New directories use 0700 and new data files use 0600.

• V0.1 uses a Scope mutex within a single process; it does not support cross- context locks or distributed deployment.

Development and validation

npm test
npm run check
npm run build

Networking docs/Project docs.

• Domain context

• Accepted ADRs

• Archived V0.1 protocol

• Archived implementation architecture