API-MARKET MCP Server

Expõe os endpoints da API-Market como recursos MCP, exigindo uma chave de API para acesso.

GitHub
4
Experimente este MCPPatrocinado

Documentação

API-MARKET MCP Server

Sobre

Um servidor Model Context Protocol (MCP) que expõe os endpoints da API-Market como recursos MCP. Este servidor permite que Modelos de Linguagem de Grande Porte descubram e interajam com APIs definidas por especificações OpenAPI através do protocolo MCP.
Este repositório fornece acesso às APIs disponíveis em API.market. A ferramenta é gratuita e permite que agentes se comuniquem livremente com todas as APIs disponíveis, tornando-a super poderosa. Com mais de 200+ APIs disponíveis em API.market, você pode aproveitar uma ampla gama de funcionalidades.

Início Rápido

Você não precisa clonar este repositório para usar este servidor MCP. Você pode simplesmente configurá-lo no cliente de sua preferência.

Para Claude Desktop

  1. Localize ou crie o arquivo de configuração do Claude Desktop:
    • No macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  2. Adicione a seguinte configuração para habilitar o servidor MCP da 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. Vá em Arquivo -> Preferências -> Configurações do Cursor.
  2. Selecione MCP.
  3. Clique em Adicionar novo servidor MCP global.
  4. Cole o seguinte no arquivo mcp.json.
  {
    "mcpServers": {
      "api-market": {
        "command": "npx",
        "args": [
          "-y",
          "@noveum-ai/mcp-server",
          "--headers",
          "x-magicapi-key:<your-api-key>"
        ]
      }
    }
  }

Alternativamente, adicione isso como a primeira entrada em mcpServers.

    "api-market": {
      "command": "npx",
      "args": [
        "-y",
        "@noveum-ai/mcp-server",
        "--headers",
        "x-magicapi-key:<your-api-key>"
      ]
    },
  1. Para versões mais antigas do Cursor, adicione o seguinte comando após clicar em Adicionar novo servidor MCP
npx -y @noveum-ai/mcp-server --headers x-magicapi-key:your-api-key

Obtendo uma Chave de API do API.market

Para obter uma chave de API

  1. Faça login em API.market
  2. Vá ao seu perfil e selecione 'Minhas Chaves de API'
  3. Suas chaves de API serão exibidas aqui

Lista de APIs neste MCP

Exemplo e Uso

Exemplo 1

Podemos usar o agente para encontrar uma rota entre quaisquer dois pontos

Example 1

Exemplo 2

Podemos usar o agente para encontrar notícias sobre qualquer tópico e depois aprofundar nos artigos

Example 2.1 Example 2.2

Exemplo 3

Podemos usar o agente para procurar domínios disponíveis

Example 3

Desenvolvimento

Adicionando uma Nova API ao Servidor MCP

A pasta utils contém scripts auxiliares para gerenciar configurações de API, analisar especificações OpenAPI e registrar novas APIs no servidor MCP.

1. Localize a Especificação OpenAPI

Encontre o JSON OpenAPI para a API que deseja integrar. Depois, crie uma pasta json_files no diretório raiz do projeto e adicione sua especificação JSON OpenAPI à pasta.

2. Modifique a Especificação OpenAPI

Após obter a especificação OpenAPI, use modify_api.py para atualizar o caminho dentro da especificação para incluir o nome do arquivo.

python utils/modify_api.py

3. Atualize os Resumos das APIs

Após modificar os caminhos, atualize os resumos das APIs escolhendo uma das seguintes opções:

  • Encurtar resumos automaticamente usando um LLM:
python utils/LLM_summary_shortener.py
  • Atualizar os resumos manualmente:
python utils/manual_summary_shortener.py

4. Compilar e Testar

Recompile o projeto para aplicar as alterações:

npm run build

Em seguida, teste a integração da nova API usando:

npm run inspect

5. Envie Suas Alterações

Se você quiser contribuir com esta nova API para o repositório:

  • Faça um fork do repositório.
  • Crie um branch.
  • Envie um pull request (PR).

6. Publique o servidor MCP (Opcional)

Se você quiser publicar suas alterações:

  • Atualize o package.json de acordo (por exemplo, atualize a versão, nome, etc.).
  • Publique o pacote:
npm publish --access public

Ferramentas de Desenvolvimento

Compilação

  • npm run build - Compila o código-fonte TypeScript.
  • npm run clean - Remove artefatos de compilação.
  • npm run typecheck - Executa a verificação de tipos do TypeScript.

Modo de Desenvolvimento

  • npm run dev - Observa os arquivos de origem e recompila em caso de alterações.
  • npm run inspect-watch - Executa o inspetor com recarga automática em caso de alterações.

Qualidade do Código

  • npm run lint - Executa o ESLint.
  • npm run typecheck - Verifica os tipos do 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"

Fluxo de Desenvolvimento

  1. Inicie o ambiente de desenvolvimento:
npm run inspect-watch
  1. Modifique os arquivos TypeScript em src/.
  2. O servidor será recompilado e reiniciado automaticamente.
  3. Use a interface do MCP Inspector para testar suas alterações.

Depuração ou Execução Local

Para depurar ou executar o servidor MCP localmente:

  1. Clone o repositório e instale as dependências:
git clone https://github.com/Noveum/api-market-mcp-server.git
cd api-market-mcp-server
npm install
  1. Compile o servidor:
npm run build
  1. Para depuração, você pode executar:
npm run inspect

Contribuindo

  1. Faça um fork do repositório.
  2. Crie um branch de funcionalidade.
  3. Faça suas alterações.
  4. Execute testes e linting:
npm run typecheck
npm run lint
  1. Envie um pull request.

Licença

MIT -->