API-MARKET MCP Server

Expone los endpoints de API-Market como recursos MCP, requiriendo una clave API para acceder.

GitHub
4

Documentación

API-MARKET MCP Server

Acerca de

Un servidor de Protocolo de Contexto de Modelo (MCP) que expone los endpoints de API-Market como recursos MCP. Este servidor permite a los Modelos de Lenguaje de Gran Tamaño descubrir e interactuar con APIs definidas por especificaciones OpenAPI a través del protocolo MCP.
Este repositorio proporciona acceso a las APIs disponibles en API.market. La herramienta es de uso gratuito y permite a los agentes comunicarse libremente con todas las APIs disponibles, lo que la hace muy potente. Con más de 200+ APIs disponibles en API.market, puedes aprovechar una amplia gama de funcionalidades.

Inicio rápido

No necesitas clonar este repositorio para usar este servidor MCP. Simplemente puedes configurarlo en el cliente de tu elección.

Para Claude Desktop

  1. Localiza o crea tu archivo de configuración de Claude Desktop:
    • En macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  2. Añade la siguiente configuración para habilitar el servidor MCP de API-Market: 
    {
  "mcpServers": {
    "api-market": {
      "command": "npx",
      "args": ["-y", "@noveum-ai/mcp-server"],
      "env": {
        "API_HEADERS": "x-magicapi-key:your-api-key"
      }
    }
  }
}

Para Cursor

  1. Ve a Archivo -> Preferencias -> Configuración de Cursor.
  2. Selecciona MCP.
  3. Haz clic en Añadir nuevo servidor MCP global.
  4. Pega lo siguiente en el archivo mcp.json.
  {
    "mcpServers": {
      "api-market": {
        "command": "npx",
        "args": [
          "-y",
          "@noveum-ai/mcp-server",
          "--headers",
          "x-magicapi-key:<your-api-key>"
        ]
      }
    }
  }

Alternativamente, añade esto como la primera entrada en mcpServers.

    "api-market": {
      "command": "npx",
      "args": [
        "-y",
        "@noveum-ai/mcp-server",
        "--headers",
        "x-magicapi-key:<your-api-key>"
      ]
    },
  1. Para versiones anteriores de Cursor, añade el siguiente comando después de hacer clic en Añadir nuevo servidor MCP
npx -y @noveum-ai/mcp-server --headers x-magicapi-key:your-api-key

Obtención de una clave de API de API.market

Para obtener una clave de API:

  1. Inicia sesión en API.market
  2. Ve a tu perfil y selecciona 'Mis claves de API'
  3. Tus claves de API se mostrarán aquí

Lista de APIs en este MCP

Ejemplo y uso

Ejemplo 1

Podemos usar el agente para encontrar una ruta entre dos puntos cualesquiera

Example 1

Ejemplo 2

Podemos usar el agente para encontrar noticias sobre cualquier tema y luego profundizar en los artículos

Example 2.1 Example 2.2

Ejemplo 3

Podemos usar el agente para buscar dominios disponibles

Example 3

Desarrollo

Añadir una nueva API al servidor MCP

La carpeta utils contiene scripts auxiliares para gestionar configuraciones de API, analizar especificaciones OpenAPI y registrar nuevas APIs en el servidor MCP.

1. Localiza la especificación OpenAPI

Encuentra el JSON de OpenAPI para la API que deseas integrar. Después, crea una carpeta json_files en el directorio raíz del proyecto y añade tu especificación JSON de OpenAPI a la carpeta

2. Modifica la especificación OpenAPI

Después de obtener la especificación OpenAPI, usa modify_api.py para actualizar la ruta dentro de la especificación para incluir el nombre del archivo.

python utils/modify_api.py

3. Actualiza los resúmenes de la API

Después de modificar las rutas, actualiza los resúmenes de la API eligiendo una de las siguientes opciones:

  • Acortar automáticamente los resúmenes usando un LLM:
python utils/LLM_summary_shortener.py
  • Actualizar manualmente los resúmenes:
python utils/manual_summary_shortener.py

4. Compilar y probar

Recompila el proyecto para aplicar los cambios:

npm run build

Luego, prueba la nueva integración de la API usando:

npm run inspect

5. Envía tus cambios

Si deseas contribuir con esta nueva API al repositorio:

  • Haz un fork del repositorio.
  • Crea una rama.
  • Envía una solicitud de extracción (PR).

6. Publica el servidor MCP (Opcional)

Si deseas publicar tus cambios:

  • Actualiza el package.json en consecuencia (por ejemplo, actualiza la versión, el nombre, etc.).
  • Publica el paquete:
npm publish --access public

Herramientas de desarrollo

Compilación

  • npm run build - Compila el código fuente de TypeScript.
  • npm run clean - Elimina los artefactos de compilación.
  • npm run typecheck - Ejecuta la comprobación de tipos de TypeScript.

Modo de desarrollo

  • npm run dev - Observa los archivos fuente y recompila ante cambios.
  • npm run inspect-watch - Ejecuta el inspector con recarga automática ante cambios.

Calidad del código

  • npm run lint - Ejecuta ESLint.
  • npm run typecheck - Verifica los tipos de TypeScript.

Command Line Arguments

npm run inspect -- \
  --api-base-url https://api.magicapi.dev/api/v1/ \
  --openapi-spec modified_files.txt \
  --headers "x-magicapi-key:your-api-key" \
  --name "my-mcp-server" \
  --version "1.0.0"

Flujo de trabajo de desarrollo

  1. Inicia el entorno de desarrollo:
npm run inspect-watch
  1. Modifica los archivos TypeScript en src/.
  2. El servidor se recompilará y reiniciará automáticamente.
  3. Usa la interfaz de usuario del Inspector MCP para probar tus cambios.

Depuración o ejecución local

Para depurar o ejecutar el servidor MCP localmente:

  1. Clona el repositorio e instala las dependencias:
git clone https://github.com/Noveum/api-market-mcp-server.git
cd api-market-mcp-server
npm install
  1. Compila el servidor:
npm run build
  1. Para depurar, puedes ejecutar:
npm run inspect

Contribuciones

  1. Haz un fork del repositorio.
  2. Crea una rama de características.
  3. Realiza tus cambios.
  4. Ejecuta pruebas y linting:
npm run typecheck
npm run lint
  1. Envía una solicitud de extracción.

Licencia

MIT -->