nei-mcp-server

Un servidor de herramientas basado en fastmcp para interactuar con la plataforma NEI, proporcionando la capacidad de consultar recursos de proyectos de NEI.

Funcionalidades principales

Este proyecto encapsula las funciones comunes de la plataforma NEI en una serie de herramientas MCP para facilitar la consulta y la integración rápidas. Las herramientas admitidas son las siguientes:

• sync_nei_project: Sincroniza a la fuerza los datos más recientes del proyecto desde la plataforma NEI remota y actualiza la caché local. Debe llamar a esta herramienta primero cuando sospeche que los datos locales no están actualizados o cuando necesite obtener información sobre interfaces de backend o modelos de datos que acaban de cambiar.

• search_interfaces_by_uri: Realiza una búsqueda difusa de recursos de interfaz en el proyecto NEI según el URI (ruta de la interfaz) definido.

• search_interfaces_by_url: Busca con precisión recursos de interfaz según el pid y el id en el enlace de detalles de la interfaz de NEI, por ejemplo, http://nei.example.com/interface/detail/?pid=10135&id=13015.

• search_interfaces_by_name: Realiza una búsqueda difusa de recursos de interfaz en el proyecto NEI según el nombre de la interfaz.

• search_groups_by_name: Busca grupos de negocio en el proyecto NEI según el nombre del grupo.

Related MCP server: YApi MCP Server

Preparación del entorno

• Node.js (se recomienda la versión v20 o superior)

• pnpm (opcional, recomendado)

Instalación y configuración

1. Clonar el proyecto

   git clone https://github.com/leila-huang/nei-mcp-server.git
   cd nei-mcp-server

2. Instalar dependencias Usando npm:

   npm install

   O pnpm:

   pnpm install

Herramientas de depuración

1. Depuración con inspect El comando inspect de fastmcp permite probar todas las herramientas de forma interactiva localmente. Es necesario configurar SERVER_URL y PROJECT_ID en la página web.

   npm run inspect

   Este comando proporcionará una interfaz interactiva donde podrá seleccionar la herramienta a ejecutar e ingresar los parámetros, lo cual es ideal para depurar y explorar.

2. Depuración con cliente mcp

       {
         "mcpServers": {
             "nei-mcp-server": {
                 "command": "npx",
                 "args": ["tsx", "/PATH/TO/YOUR_PROJECT/src/index.ts"],
                 "env": {
                     "SERVER_URL": "xxx",
                     "PROJECT_ID": "xxx"
                 }
             }
         }
       }

Guía de uso de mcp

```bash
{
    "mcpServers": {
        "nei-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@leila329/nei-mcp-server"
            ],
            "env": {
                "SERVER_URL": "xxx",
                "PROJECT_ID": "xxx"
            }
        }
    }
}
```

Mecanismo de caché

Para mejorar el rendimiento y reducir la presión de las solicitudes al servidor NEI, este proyecto implementa una estrategia de caché simple:

1. Caché en memoria: Los datos se almacenan en la memoria después de la primera carga. Durante una única ejecución del servicio, las solicitudes posteriores idénticas se devolverán directamente desde la memoria, evitando solicitudes de red repetidas. La caché en memoria se borrará después de reiniciar el servicio.

2. Sincronización de red: Al iniciar el servicio, o al llamar manualmente a la herramienta sync_nei_project, se extraerán los datos más recientes del proyecto desde el servidor remoto de NEI y se actualizará la caché en memoria.

Puede forzar manualmente la sincronización de red llamando a la herramienta sync_nei_project para asegurarse de que los datos sean la versión más reciente.