Servidor MCP de API-MARKET

Acerca de

Un servidor de Protocolo de Contexto de Modelo (MCP) que expone los endpoints de API-Market como recursos MCP. Este servidor permite que los Modelos de Lenguaje Grandes (ML) descubran e interactúen con las API definidas por las especificaciones de OpenAPI mediante el protocolo MCP.
Este repositorio proporciona acceso a las API disponibles en API.market . La herramienta es gratuita y permite a los agentes comunicarse libremente con todas las API disponibles, lo que la hace extremadamente potente. Con más de 200 API disponibles en API.market , puede aprovechar una amplia gama de funcionalidades.

Related MCP server: OpenAPI MCP Server

Inicio rápido

No es necesario clonar este repositorio para usar este servidor MCP. Simplemente puede configurarlo en el cliente que prefiera.

Para Claude Desktop

1. Localice o cree su archivo de configuración de Claude Desktop:

   • En macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

2. Agregue 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 el cursor

1. Vaya a Archivo -> Preferencias -> Configuración del cursor.

2. Seleccione MCP.

3. Haga clic en Agregar nuevo servidor MCP global.

4. Pegue 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, agregue esto como la primera entrada en mcpServers.

    "api-market": {
      "command": "npx",
      "args": [
        "-y",
        "@noveum-ai/mcp-server",
        "--headers",
        "x-magicapi-key:<your-api-key>"
      ]
    },

5. Para versiones anteriores de Cursor, agregue el siguiente comando después de hacer clic en Agregar nuevo servidor MCP

npx -y @noveum-ai/mcp-server --headers x-magicapi-key:your-api-key

Obtener una clave API de API.market

Para obtener una clave API

1. Inicie sesión en API.market

2. Vaya a su perfil y seleccione 'Mis claves API'

3. Tus claves API se mostrarán aquí

Lista de API en este MCP

• GET-trueway-matrix-MatrixService-CalculateDrivingMatrix

• GET-magicapi-whisper-predictions--id de solicitud

• POST-magicapi-susurro-susurro

• Subida de POST-capix-faceswap

• POST-capix-faceswap-faceswap-v1-image

• POST-capix-faceswap-faceswap-v1-video

• Resultado de POST-capix-faceswap

• GET-trueway-geocoding-Servicio de geocodificación-Geocodificación

• GET-trueway-geocoding-Servicio de geocodificación-ReverseGeocode

• POST-magicapi-dnschecker-dnschecker

• GET-magicapi-coder-predictions--id_solicitud

• POST-magicapi-coder-coder

• POST-bridgeml-nsfw-detection-nsfw_detection

• GET-magicapi-whois-whois-dominio-

• GET-magicapi-deblurer-predictions--id de solicitud

• POST-magicapi-deblurer-deblurer

• POST-bridgeml-texto-a-imagen-texto_a_imagen

• GET-magicapi-periodo-predicciones--solicitud_id

• POST-magicapi-periodo-periodo

• GET-trueway-places-Servicio de lugares-Buscar lugar por texto

• GET-trueway-places-Servicio de lugares-Buscar lugares cercanos

• GET-magicapi-predicciones-de-cabello--solicitud_id

• POST-magicapi-cabello-cabello

• POST-bridgeml-codellama-bridgeml-codellama

• GET-brave-brave-videos-buscar

• GET-brave-brave-web-search

• GET-brave-brave-images-search

• GET-brave-brave-news-search

• GET-brave-brave-sugerencia-búsqueda

• GET-brave-brave-corrector-ortográfico-búsqueda

• POST-magicapi-domainchecker-verificar_dominios

• GET-trueway-routing-DireccionesServicio-BuscarRutaDeConducción

• GET-trueway-routing-DireccionesServicio-BuscarRutaDeConducción

• Análisis y extracción de POST-pipfeed

Ejemplo y uso

Ejemplo 1

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

Ejemplo 2

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

Ejemplo 3

Podemos usar el agente para buscar dominios disponibles

Desarrollo

Agregar una nueva API al servidor MCP

La carpeta utils contiene scripts útiles para administrar configuraciones de API, analizar especificaciones de OpenAPI y registrar nuevas API en el servidor MCP.

1. Localice la especificación OpenAPI

Busque el JSON de OpenAPI para la API que desea integrar. Después, cree la carpeta json_files en el directorio raíz del proyecto y añada su especificación JSON de OpenAPI a ella.

2. Modificar la especificación de OpenAPI

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

python utils/modify_api.py

3. Actualizar resúmenes de API

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

• Acortar automáticamente los resúmenes utilizando un LLM:

python utils/LLM_summary_shortener.py 

• Actualizar manualmente los resúmenes:

python utils/manual_summary_shortener.py 

4. Construir y probar

Reconstruya el proyecto para aplicar los cambios:

npm run build

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

npm run inspect

5. Envíe sus cambios

Si desea aportar esta nueva API al repositorio:

• Bifurcar el repositorio.

• Crear una rama.

• Enviar una solicitud de extracción (PR).

6. Publicar el servidor MCP (opcional)

Si desea publicar sus cambios:

• Actualice el package.json según corresponda (por ejemplo, actualice la versión, el nombre, etc.).

• Publicar el paquete:

npm publish --access public

Herramientas de desarrollo

Edificio

• npm run build : crea la fuente TypeScript.

• npm run clean : elimina los artefactos de compilación.

• npm run typecheck : ejecuta la verificación de tipos de TypeScript.

Modo de desarrollo

• npm run dev : supervisa los archivos de origen y reconstruye según los 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.

Argumentos de la línea de comandos

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. Iniciar el entorno de desarrollo:

npm run inspect-watch

2. Modificar los archivos TypeScript en src/ .

3. El servidor se reconstruirá y reiniciará automáticamente.

4. Utilice la interfaz de usuario del Inspector MCP para probar sus cambios.

Depuración o ejecución local

Para depurar o ejecutar el servidor MCP localmente:

1. Clonar el repositorio e instalar las dependencias:

git clone https://github.com/Noveum/api-market-mcp-server.git
cd api-market-mcp-server
npm install

2. Construir el servidor:

npm run build

3. Para depurar, puede ejecutar:

npm run inspect 

Contribuyendo

1. Bifurcar el repositorio.

2. Crear una rama de características.

3. Realice sus cambios.

4. Ejecutar pruebas y linting:

npm run typecheck
npm run lint

5. Enviar una solicitud de extracción.

Licencia

Instituto Tecnológico de Massachusetts (MIT)