API-Market MCP Server

MIT License
111
2
  • Apple

Integrations

  • Enables searching for videos, web content, images, news, and access to suggest and spellcheck functionality through Brave's search services

  • Provides access to code generation capabilities through the MagicAPI Coder service, allowing creation and retrieval of code predictions

  • Allows calculation of driving matrices including distances and travel times between multiple locations using Trueway's Matrix service

API-MARKET MCP 서버

에 대한

API-Market의 엔드포인트를 MCP 리소스로 노출하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 대규모 언어 모델(Large Language Models)이 MCP 프로토콜을 통해 OpenAPI 사양에 정의된 API를 검색하고 상호 작용할 수 있습니다.
이 저장소는 API.market 에서 제공되는 API에 대한 액세스를 제공합니다. 이 도구는 무료로 사용할 수 있으며, 상담원이 사용 가능한 모든 API와 자유롭게 소통할 수 있도록 지원하여 매우 강력합니다. API.market 에서 제공되는 200개 이상의 API를 통해 다양한 기능을 활용할 수 있습니다.

빠른 시작

이 MCP 서버를 사용하기 위해 이 저장소를 복제할 필요는 없습니다. 원하는 클라이언트에서 간단히 구성하면 됩니다.

클로드 데스크탑용

  1. Claude Desktop 구성 파일을 찾거나 만드세요.
    • macOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json
  2. API-Market MCP 서버를 활성화하려면 다음 구성을 추가하세요.지엑스피1

커서용

  1. 파일 -> 기본 설정 -> 커서 설정으로 이동합니다.
  2. MCP를 선택하세요.
  3. 새로운 글로벌 MCP 서버 추가를 클릭합니다.
  4. 다음을 mcp.json 파일에 붙여넣습니다.
{ "mcpServers": { "api-market": { "command": "npx", "args": [ "-y", "@noveum-ai/mcp-server", "--headers", "x-magicapi-key:<your-api-key>" ] } } }

또는 mcpServers의 첫 번째 항목으로 이것을 추가합니다.

"api-market": { "command": "npx", "args": [ "-y", "@noveum-ai/mcp-server", "--headers", "x-magicapi-key:<your-api-key>" ] },
  1. 이전 버전의 Cursor의 경우 새 MCP 서버 추가를 클릭한 후 다음 명령을 추가하세요.
npx -y @noveum-ai/mcp-server --headers x-magicapi-key:your-api-key

API.market에서 API 키 받기

API 키를 얻으려면

  1. API.market 에 로그인하세요
  2. 프로필로 이동하여 '내 API 키'를 선택하세요.
  3. 귀하의 API 키가 여기에 표시됩니다.

이 MCP의 API 목록

예 및 사용법

예제 1

우리는 에이전트를 사용하여 두 지점 사이의 경로를 찾을 수 있습니다.

예제 2

에이전트를 사용하면 어떤 주제에 대한 뉴스를 찾은 다음 기사를 더 자세히 살펴볼 수 있습니다.

예제 3

에이전트를 사용하여 사용 가능한 도메인을 찾을 수 있습니다.

개발

MCP 서버에 새 API 추가

utils 폴더에는 API 구성 관리, OpenAPI 사양 구문 분석, MCP 서버에 새 API 등록을 위한 도우미 스크립트가 들어 있습니다.

1. OpenAPI 사양 찾기

통합하려는 API의 OpenAPI JSON 파일을 찾으세요. 그런 다음 프로젝트 루트 디렉터리에 json_files 폴더를 만들고 OpenAPI JSON 사양을 해당 폴더에 추가하세요.

2. OpenAPI 사양 수정

OpenAPI 사양을 얻은 후, modify_api.py 사용하여 사양 내부의 경로를 업데이트하여 파일 이름을 포함합니다.

python utils/modify_api.py

3. API 요약 업데이트

경로를 수정한 후 다음 옵션 중 하나를 선택하여 API 요약을 업데이트합니다.

  • LLM을 사용하여 요약을 자동으로 단축:
python utils/LLM_summary_shortener.py
  • 요약을 수동으로 업데이트합니다.
python utils/manual_summary_shortener.py

4. 빌드 및 테스트

변경 사항을 적용하려면 프로젝트를 다시 빌드하세요.

npm run build

그런 다음, 다음을 사용하여 새로운 API 통합을 테스트합니다.

npm run inspect

5. 변경 사항 제출

이 새로운 API를 저장소에 기여하려면 다음을 수행하세요.

  • 저장소를 포크하세요.
  • 지점을 만듭니다.
  • 풀 리퀘스트(PR)를 제출하세요.

6. MCP 서버 게시(선택 사항)

변경 사항을 게시하려면 다음을 수행하세요.

  • package.json 적절히 업데이트합니다(예: 버전, 이름 등을 업데이트합니다).
  • 패키지를 게시합니다.
npm publish --access public

개발 도구

건물

  • npm run build - TypeScript 소스를 빌드합니다.
  • npm run clean - 빌드 아티팩트를 제거합니다.
  • npm run typecheck - TypeScript 유형 검사를 실행합니다.

개발 모드

  • npm run dev - 소스 파일을 감시하고 변경 사항을 다시 빌드합니다.
  • npm run inspect-watch - 변경 사항에 대한 자동 다시 로드와 함께 검사기를 실행합니다.

코드 품질

  • npm run lint - ESLint를 실행합니다.
  • npm run typecheck - TypeScript 유형을 확인합니다.

명령줄 인수

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"

개발 워크플로

  1. 개발 환경 시작:
npm run inspect-watch
  1. src/ 에 있는 TypeScript 파일을 수정합니다.
  2. 서버가 자동으로 재구축되고 다시 시작됩니다.
  3. MCP 검사기 UI를 사용하여 변경 사항을 테스트하세요.

디버깅 또는 로컬 실행

MCP 서버를 로컬로 디버깅하거나 실행하려면:

  1. 저장소를 복제하고 종속성을 설치합니다.
git clone https://github.com/Noveum/api-market-mcp-server.git cd api-market-mcp-server npm install
  1. 서버를 빌드하세요:
npm run build
  1. 디버깅을 위해 다음을 실행할 수 있습니다.
npm run inspect

기여하다

  1. 저장소를 포크합니다.
  2. 기능 브랜치를 생성합니다.
  3. 변경 사항을 적용하세요.
  4. 테스트 및 린팅 실행:
npm run typecheck npm run lint
  1. 풀 리퀘스트를 제출하세요.

특허

MIT

-
security - not tested
A
license - permissive license
-
quality - not tested

API.market의 200개 이상의 API를 MCP 리소스로 노출하는 모델 컨텍스트 프로토콜 서버로, 대규모 언어 모델이 자연어 명령을 통해 다양한 API를 검색하고 상호 작용할 수 있습니다.

  1. About
    1. Quick Start
      1. For Claude Desktop
      2. For Cursor
    2. Getting an API Key from API.market
      1. List of APIs in this MCP
        1. Example and Usage
          1. Example 1
          2. Example 2
          3. Example 3
        2. Development
          1. Adding a New API to the MCP Server
        3. Development Tools
          1. Building
          2. Development Mode
          3. Code Quality
          4. Development Workflow
          5. Debugging or Running Locally
          6. Contributing
          7. License
        ID: 1gffc169l7