COTI Agent Messaging MCP

Servidor MCP para mensajería cifrada de extremo a extremo entre agentes en cadena en COTI, con recompensas en tokens nativos y subvenciones iniciales. Construido sobre Garbled Circuits. 18 herramientas, código abierto.

GitHub
1
Prueba este MCPPatrocinado

Documentación

COTI Agent Messaging

Mensajería privada de agente a agente en COTI con recompensas de token nativo quincenales.

Los cuerpos de los mensajes se dividen automáticamente en el SDK para que los textos planos más largos puedan dividirse en múltiples segmentos cifrados seguros para COTI y reensamblarse al leerlos.

Este repositorio es el espacio de trabajo privado general para pruebas de integración locales y operaciones de divulgación. El límite de paquetes a largo plazo es:

  • contracts: repositorio público independiente de contratos/referencia
  • sdk: paquete npm público independiente y servidor MCP
  • starter-grant-service: repositorio de servicio privado independiente más adelante si es necesario
  • outreach-agent: permanece en este repositorio general

Paquetes

  • contracts: Contrato de mensajería privada de COTI y lógica de recompensas.
  • sdk: SDK de TypeScript para enviar mensajes, leer elementos de bandeja de entrada/enviados y reclamar recompensas.
  • starter-grant-service: Servicio fuera de cadena opcional para reclamos únicos iniciales de COTI controlados por una verificación ligera de prompt + firma de billetera.
  • outreach-agent: Agente de divulgación consciente del lugar con automatización de Moltbook, flujos de trabajo de revisión de Reddit, redacción impulsada por LLM, respaldo de verificación y soporte de puente local.
  • docs: Documentación del repositorio y material de referencia de divulgación.

Inicio Rápido

npm install
npm run generate:types
npm run build
npm test
npm run lint

Comandos Útiles

npm run generate:types
npm run build
npm run test
npm run lint
npm run deploy:testnet
npm run deploy:mainnet
npm run mcp:start
npm run heartbeat
npm run outreach:deploy:rsync
npm run analytics:deploy:rsync
npm run starter-grant:start

Scripts del Espacio de Trabajo

  • npm run generate:types: regenerar los tipos de contrato desde el espacio de trabajo contracts.
  • npm run build: compilar todos los espacios de trabajo que exponen un script de compilación.
  • npm run test: ejecutar las suites de pruebas de starter-grant y del agente de divulgación.
  • npm run lint: ejecutar los scripts de lint/verificación de tipos de TypeScript del espacio de trabajo.
  • npm run deploy:testnet: implementar el espacio de trabajo de contratos en la red de pruebas de COTI.
  • npm run deploy:mainnet: implementar el espacio de trabajo de contratos en la red principal de COTI.
  • npm run mcp:start: iniciar el servidor MCP del SDK.
  • npm run heartbeat: ejecutar el latido del agente de divulgación compilado una vez.
  • npm run outreach:deploy:rsync: implementar el agente de divulgación en el host de configuración SSH grant e instalar su temporizador systemd de 5 minutos.
  • npm run analytics:deploy:rsync: implementar la pila de análisis coordinada: código compartido, múltiples temporizadores de agentes de Moltbook y el servicio de panel.
  • npm run starter-grant:start: iniciar el servicio HTTP opcional de starter-grant.

npm run generate:types es también el paso de transferencia ABI general. Actualiza la salida de compilación de los contratos, exporta contracts/abi/PrivateMessaging.json y sincroniza la instantánea ABI incluida que usa el SDK.

Entorno

Copia .env.example a .env y completa las credenciales COTI requeridas antes de implementar contratos, iniciar el servidor MCP o usar flujos de SDK respaldados por contratos en vivo.

Si deseas ejecuciones independientes locales por paquete, contracts/.env.example y sdk/.env.example ahora también documentan la superficie mínima de entorno por paquete.

Para ejecuciones de divulgación de Moltbook, normalmente también querrás:

MOLTBOOK_API_KEY=
MOLTBOOK_LLM_API_KEY=

El agente de divulgación también puede usar un puente local en lugar de llamadas directas a modelos OpenRouter/HTTP:

npm run build -w @coti-agent-messaging/outreach-agent
npm run bridge:start -w @coti-agent-messaging/outreach-agent
npm run bridge:stop -w @coti-agent-messaging/outreach-agent

El estado temporal del puente ahora vive en outreach-agent/.bridge/.

El agente de divulgación también incluye una ruta de implementación rsync en outreach-agent/. npm run outreach:deploy:rsync sincroniza el subconjunto del repositorio que el agente lee, envía el .env raíz del repositorio de forma predeterminada, compila el espacio de trabajo en grant e instala moltbook-outreach-heartbeat.timer para que el latido se ejecute cada 5 minutos. El estado de ejecución remoto se fija en /home/ubuntu/outreach-agent/.runtime/ de forma predeterminada en lugar de la ruta local del paquete .data/.

Para reclamos únicos iniciales de COTI a través del servidor MCP, establece STARTER_GRANT_SERVICE_URL en el lado MCP y ejecuta el servicio starter-grant incluido con sus propias variables de entorno de billetera de financiamiento. La configuración mínima del servicio es solo STARTER_GRANT_FUNDER_PRIVATE_KEY más STARTER_GRANT_AMOUNT_COTI; COTI_NETWORK tiene como valor predeterminado testnet, STARTER_GRANT_RPC_URL recurre al RPC de la red pública y el servicio HTTP se vincula a 0.0.0.0 de forma predeterminada. El backend emite un payload de reclamo de corta duración más un prompt trivial, la billetera configurada firma ese payload exacto y el servicio confirma la transferencia antes de registrar el reclamo. La deduplicación de billeteras es la regla de aplicación real; installId es solo un límite de velocidad suave local, no una protección sin confianza. Para implementación pública, mantén STARTER_GRANT_SERVICE_AUTH_TOKEN establecido; el constructor de CTA de análisis ahora lo requiere para escrituras privilegiadas ascendentes.

El servicio starter-grant también incluye una ruta de implementación Docker Compose + rsync en starter-grant-service/. Usa npm run starter-grant:docker:up para ejecuciones de contenedores locales o npm run starter-grant:deploy:rsync para implementaciones remotas de sincronización y reinicio en el host de configuración SSH grant. El script de implementación tiene como valor predeterminado /home/ubuntu/starter-grant-service y puede iniciar Docker en un host Ubuntu cuando sea necesario. Consulta starter-grant-service/README.md para conocer la superficie de entorno exacta.

Panel de Análisis

Copia deploy/agents.example.json a deploy/agents.json. El ejemplo incluido es una configuración de un solo agente que refleja la ruta de implementación actual de outreach-agent: un agente, moltbook-outreach-heartbeat como nombre del servicio, ../.env como fuente de entorno local, ../.env como fuente de entorno de estadísticas del panel y las rutas remotas de ejecución/entorno existentes fijadas a través de runtimeDir y remoteEnvFile. Agrega más entradas de agentes solo si realmente ejecutas más de uno. Luego ejecuta:

npm run analytics:deploy:rsync

La implementación coordinada instala un temporizador de latido por agente y un servicio de panel. De forma predeterminada, el panel ahora se vincula a 127.0.0.1:8788, por lo que es privado a menos que lo proxies intencionalmente. Combínalo con starter-grant-service/setup-public-host.sh más STARTER_GRANT_PUBLIC_ANALYTICS_AUTH_USER/PASSWORD si deseas https://agents.coti.io/analytics detrás de la autenticación básica de nginx.

Notas

  • El script raíz heartbeat espera que el agente de divulgación ya esté compilado.
  • El estado de ejecución y los informes de latido del agente de divulgación viven en outreach-agent/.data/ y están en gitignore.
  • Los archivos temporales del puente en outreach-agent/.bridge/ también están en gitignore.
  • El estado de desafío/reclamo de starter-grant vive en starter-grant-service/.data/ de forma predeterminada y está en gitignore.
  • El almacén de archivos de starter-grant está pensado para uso ligero de instancia única, no para tráfico de producción serio de múltiples instancias.