Servidor MCP de Cyberlink

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con el contrato inteligente de CW-Social en cadenas de bloques basadas en Cosmos. Este servidor proporciona una interfaz estandarizada para crear, actualizar y consultar ciberenlaces (relaciones semánticas entre entidades en la cadena de bloques).

Características

• Operaciones principales

  • Crear, leer, actualizar y eliminar enlaces cibernéticos

  • Compatibilidad con enlaces cibernéticos con nombre e identificadores personalizados

  • Operaciones por lotes para un procesamiento eficiente

  • Amplias capacidades de consulta con filtrado y paginación

• Gestión de transacciones

  • Monitoreo de transacciones en tiempo real y sondeo de estado

  • Resultados detallados de transacciones y manejo de errores

  • Soporte para firma de transacciones internas y externas

  • Capacidades de transferencia de tokens

• Funciones avanzadas

  • Generación de incrustación semántica mediante transformadores Hugging Face

  • Seguimiento del progreso en tiempo real de las operaciones del modelo

  • Cálculos de similitud de coseno para correspondencia semántica

  • Sistema de identificación flexible con identificaciones formateadas (fids) e identificaciones globales (gids)

  • Consultas basadas en rango de tiempo con soporte UTC

  • Filtrado y estadísticas basados en el propietario

Related MCP server: Contextual MCP Server

Prerrequisitos

• Node.js 16 o superior

• gestor de paquetes npm o yarn

• Acceso a un nodo de blockchain de Cosmos en ejecución

• Billetera con fondos suficientes para transacciones

• Cursor IDE para desarrollo

• Claude Desktop para asistencia de IA

Instalación

1. Clonar el repositorio:

git clone https://github.com/your-org/cw-social-mcp.git
cd cw-social-mcp

2. Instalar dependencias:

npm install

3. Construir el proyecto:

npm run build

4. Configurar variables de entorno (ver sección Configuración)

Configuración

Configuración del servidor MCP

Cree o modifique el archivo de configuración en ~/.cursor/mcp.json :

{
  "mcpServers": {
    "cw-graph": {
      "command": "node",
      "args": ["PATH_TO_YOUR_PROJECT/dist/index.js"],
      "env": {
        "NODE_URL": "http://localhost:26657",
        "WALLET_MNEMONIC": "your wallet mnemonic phrase",
        "CONTRACT_ADDRESS": "your contract address",
        "DENOM": "stake",
        "BENCH32_PREFIX": "cyber"
      }
    }
  }
}

Configuración requerida

Variables de entorno requeridas:

• PATH_TO_YOUR_PROJECT : Ruta absoluta al directorio del proyecto

• NODE_URL : URL del nodo de la cadena de bloques Cosmos

• CONTRACT_ADDRESS : Dirección del contrato inteligente implementado

Configuración opcional

Variables de entorno opcionales:

• WALLET_MNEMONIC : Mnemotécnico de billetera para firmar (predeterminado: ninguno - las transacciones no estarán firmadas)

• DENOM : Denominación del token (predeterminado: "participación")

• BENCH32_PREFIX : prefijo BECH32

Herramientas disponibles

Gestión de Cyberlink

Herramientas de creación

crear_ciberenlace

• Descripción: Crear un único enlace cibernético

• Requerido: type

• Opcional: from , to , value

crear_ciberenlace2

• Descripción: Crear nodo + enlace

• Obligatorio: node_type , link_type

• Opcional: node_value , link_value , link_to_existing_id , link_from_existing_id

crear_ciberenlace_nombrado

• Descripción: Crear un enlace cibernético con nombre (solo administrador)

• Requerido: name , cyberlink

crear_ciberenlaces

• Descripción: Creación de enlaces cibernéticos por lotes

• Requerido: cyberlinks[]

Herramientas de modificación

actualizar_ciberenlace

• Descripción: Actualizar el enlace cibernético existente

• Requerido: gid , cyberlink

eliminar_ciberenlace

• Descripción: Eliminar cyberlink

• Requerido: gid

actualización_con_incrustación

• Descripción: Agregar incrustación semántica

• Obligatorio: formatted_id

Operaciones de consulta

Consultas básicas

consulta_por_gid

• Descripción: Obtener por ID global

• Requerido: gid

consulta_por_fid

• Descripción: Obtener por ID formateado

• Requerido: fid

consulta_ciberenlaces

• Descripción: Listar todo con paginación

• Parámetros: limit , start_after

consulta_denominada_ciberenlaces

• Descripción: Lista de enlaces cibernéticos nombrados

• Parámetros: limit , start_after

consulta_por_gids

• Descripción: Obtener múltiples por ID

• Obligatorio: gids[]

Consultas filtradas

consulta_ciberenlaces_por_tipo

• Descripción: Filtrar por tipo

• Requerido: type

consulta_ciberenlaces_por_desde

• Descripción: Filtrar por fuente

• Requerido: from

consulta_ciberenlaces_por_a

• Descripción: Filtrar por objetivo

• Requerido: to

consulta_ciberenlaces_por_propietario_y_tipo

• Descripción: Filtrar por propietario y tipo

• Requerido: owner , type

Consultas basadas en el tiempo

consulta_ciberenlaces_por_tiempo_de_propietario

• Descripción: Filtrar por hora de creación

• Obligatorio: owner , start_time

consulta_ciberenlaces_por_propietario_tiempo_cualquiera

• Descripción: Filtrar por cualquier horario

• Obligatorio: owner , start_time

Operaciones del sistema

Información del contrato

último_id_de_la_consulta

• Descripción: Obtener la última identificación asignada

configuración de consulta

• Descripción: Obtener la configuración del contrato

estado_de_depuración_de_consulta

• Descripción: Obtener el estado de depuración (solo administrador)

obtener_estadísticas_gráficas

• Descripción: Obtener estadísticas de gráficos

Transacción y Monedero

transacción_de_consulta

• Descripción: Obtener el estado de la transacción

• Obligatorio: transaction_hash

obtener_estado_tx

• Descripción: Obtenga el estado detallado de la transacción

• Obligatorio: transaction_hash

consulta_saldo_de_la_billetera

• Descripción: Obtener saldos de billetera

enviar_tokens

• Descripción: Tokens de transferencia

• Requerido: recipient , amount

Parámetros de consulta

Formato de rango de tiempo

• Todas las marcas de tiempo deben estar en formato ISO 8601

• Ejemplo: 2024-06-01T12:00:00Z

• Se asume la zona horaria UTC si no se especifica

• start_time es obligatorio, end_time es opcional

Paginación

• start_after : Cursor de paginación

• limit : Resultados por página (predeterminado: 50)

Desarrollo

Comandos de compilación

# Production build
npm run build

# Development mode
npm run dev

Estructura del proyecto

src/
├── index.ts                # Entry point
├── cyberlink-service.ts    # Core service
├── services/
│   ├── embedding.service.ts  # Semantic analysis
│   └── __tests__/           # Test suite
└── types.ts                # Type definitions

cursor_rules/
└── chat_history.mdc       # Chat rules

Códigos de error

Parámetros no válidos

• Descripción: Parámetros no válidos

• Causas comunes: campos obligatorios faltantes, formato incorrecto

Método no encontrado

• Descripción: Herramienta desconocida

• Causas comunes: Error tipográfico en el nombre de la herramienta, herramienta obsoleta

Error interno

• Descripción: Error del sistema

• Causas comunes: Problemas de red, errores de contrato

Ejecutar MCP sobre SSE

Puedes ejecutar el servidor MCP con Docker para convertirlo en un servidor SSE. Esto garantiza que la caché del modelo Hugging Face persista entre ejecuciones y que las variables de entorno se carguen desde el archivo .env.

docker run \
  --name cw-social \
  -v $(pwd)/hf-cache:/app/hf-cache \
  --env-file .env \
  -p 8000:8000 \
  cw-social-mcp

• -v $(pwd)/hf-cache:/app/hf-cache monta un directorio local para el almacenamiento en caché de modelos, de modo que los modelos no se vuelvan a descargar cada vez.

• --env-file .env carga las variables de entorno de su archivo .env .

• -p 8000:8000 expone el servidor en el puerto 8000.

• --name cw-social nombra su contenedor para una administración más sencilla.

Contribuyendo

1. Bifurcar el repositorio

2. Crear una rama de características ( git checkout -b feature/amazing-feature )

3. Confirme sus cambios ( git commit -m 'Add amazing feature' )

4. Empujar a la rama ( git push origin feature/amazing-feature )

5. Abrir una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.