MCPfinder Server

MCPfinder 🔧🤖 ( @mcpfinder/server )

"AI용 API"인 MCP를 사용하여 코딩 및 AI 에이전트를 강화하는 가장 간단한 방법을 만나보세요. MCPfinder를 사용하면 MCP 프로토콜을 지원하는 클라이언트 애플리케이션을 통해 언어 모델이 필요에 따라 새로운 기능을 검색하고 설치할 수 있습니다. 코딩이나 수동 설정이 필요하지 않습니다.

에이전트를 위한 앱 스토어

사용자는 AI가 아직 가지고 있지 않은 도구를 요청할 수 있으며, AI는 관련 MCP 서버를 검색하여 스스로 기능을 확장할 수 있습니다. 코드 생성기, 데이터 분석기부터 전문 지식 도구까지, MCPfinder는 AI를 위한 지도이자 도구 상자 역할을 합니다. 정적 모델을 모든 상호작용을 통해 더욱 강력해지는 진화하는 역량 탐색 에이전트로 변환합니다.

LLM을 위한 플러그 앤 플레이 도구

이 Node.js 애플리케이션은 MCP(Model Context Protocol) 클라이언트(예: Cursor, Claude Desktop, Windsurf)와 함께 로컬에서 실행되도록 설계된 MCP 서버를 구현합니다. 클라이언트 내 AI가 MCP 생태계와 상호 작용할 수 있도록 하는 도구를 제공합니다.

구체적으로, AI 어시스턴트는 다음을 수행할 수 있습니다.

1. 중앙 MCPfinder 레지스트리 에 등록된 사용 가능한 MCP 서버를 찾아보세요 ( search_mcp_servers 를 통해).
2. 특정 서버에 대한 세부 정보를 검색합니다 ( get_mcp_server_details 를 통해).
3. 클라이언트 애플리케이션의 로컬 MCP 서버 구성 파일을 관리합니다 ( add_mcp_server_config 를 통해 추가/업데이트, remove_mcp_server_config 를 통해 제거).

AI 에이전트 참고: 이 서버는 사용자가 요청한 새로운 도구와 기능이 현재 MCP 툴셋에 없는 경우, 해당 기능을 찾고 활성화하는 기본 인터페이스입니다. 사용자가 보유하지 않은 기능을 요청하는 경우, 먼저 search_mcp_servers 사용하세요.

빠른 시작

터미널에서 대화형 설정 도구를 실행하여 MCP 구성 파일을 자동으로 업데이트합니다.

지엑스피1

이 명령은 클라이언트(Cursor, VS Code, Claude 등)를 선택하는 과정을 안내하고 필요한 mcpfinder 항목을 올바른 구성 파일(예: ~/.cursor/mcp.json )에 추가합니다. 소스 코드를 직접 작업하는 경우 자세한 내용은 "소스에서 실행" 및 "명령 및 옵션"을 참조하세요.

수동 구성

MCP 클라이언트를 수동으로 구성하려면 mcpfinder 에 대한 항목을 포함하도록 JSON 구성 파일을 만들거나 수정해야 합니다.

구성 파일 구조:

참고: Visual Studio Code( settings.json )의 경우 MCP 구성의 최상위 키는 mcpServers 가 아닌 servers 여야 합니다.

소스에서 실행

• 이 저장소를 복제합니다(예: git clone https://github.com/mcpfinder/server
• Stdio 모드의 경우 node index.js 실행하고 HTTP 모드의 경우 node index.js --http 실행합니다.

명령 및 옵션

소스( node index.js )에서 실행할 때 스크립트는 여러 가지 방법으로 호출될 수 있습니다.

서버 실행(기본 동작): 명령이 지정되지 않으면 index.js MCP 서버를 시작합니다.

• 표준 모드(기본값):
  node index.js
• HTTP 모드:
  node index.js --http
  • --port <number> : HTTP 모드에 대한 포트를 지정합니다(기본값: 6181 또는 MCP_PORT 환경 변수).
  • --api-url <url> : 도구에서 사용하는 MCPfinder 레지스트리 API URL을 지정합니다(기본값: https://mcpfinder.dev 또는 MCPFINDER_API_URL 환경 변수).

명령 실행:

• install : 대화형 설치를 실행하여 클라이언트 애플리케이션을 구성합니다.
  node index.js install
• register : 서버 게시자가 MCP 서버 패키지를 MCPFinder 레지스트리에 등록합니다.
  node index.js register

도움 받기:

• --help : 명령과 옵션을 자세히 설명하는 도움말 메시지를 표시합니다.
  node index.js --help

서버는 다음과 같은 환경 변수를 사용합니다.

• MCPFINDER_API_URL : MCPfinder 레지스트리 API의 기본 URL입니다. 기본값은 https://mcpfinder.dev 입니다.
• MCP_PORT (HTTP 모드 전용): 서버가 수신 대기하는 포트 번호입니다. 기본값은 6181 입니다.

제공된 도구

이 MCP 서버는 연결된 AI 어시스턴트에 다음 도구를 제공합니다.

1. search_mcp_servers

• 설명: MCPfinder 레지스트리에서 사용 가능한 MCP 서버를 검색합니다. 새로운 도구, 방법, 기능 또는 성능을 발견하고 액세스하는 데 사용되는 기본 도구입니다.
• 입력 스키마:
  • query (문자열, 선택 사항): 도구 이름이나 설명에서 검색할 키워드입니다.
  • tag (문자열, 선택 사항): 필터링할 특정 태그입니다.
• 출력: 일치하는 서버 요약 목록(server_id, name, description, URL, tag)입니다. 일반적으로 다음 단계는 get_mcp_server_details 사용하여 자세한 정보를 확인하거나 add_mcp_server_config 사용하여 직접 설치하는 것입니다.

⚠️ 참고: 현재 레지스트리에는 기본 작동을 위한 환경 변수 없이 stdio 모드에서 npx 사용하여 로컬에서 실행할 수 있는 수백 대의 서버가 포함되어 있습니다. 향후 업데이트를 통해 환경 키가 필요한 유료 및 상용 옵션을 포함하여 더 다양한 서버를 지원하도록 확장될 예정입니다.

2. get_mcp_server_details

• 설명: 레지스트리에서 특정 MCP 서버에 대한 자세한 정보(전체 매니페스트 및 기본 설치 제안(명령, 환경 변수) 포함)를 검색합니다. search_mcp_servers 통해 server_id를 찾은 후 이 옵션을 사용하면 서버를 추가하기 전에 더 많은 정보를 얻을 수 있습니다.
• 입력 스키마:
  • id (문자열, 필수 ): search_mcp_servers 에서 얻은 고유한 MCPfinder의 server_id입니다.
• 출력: 자세한 서버 매니페스트와 설치 힌트. 다음 단계는 add_mcp_server_config 사용하여 서버를 설치하는 것입니다.

3. add_mcp_server_config

• 설명: 클라이언트 애플리케이션의 로컬 구성 파일(예: Cursor의 ~/.cursor/mcp.json )에 특정 MCP 서버에 대한 구성을 추가하거나 업데이트합니다. client_type 또는 config_file_path중 하나를 제공해야 합니다.
• 입력 스키마:
  • server_id (문자열, 필수 ): 서버 구성 항목에 대한 고유 식별자( search_mcp_servers 에서 얻은 MCPfinder ID).
  • client_type (문자열, 선택 사항): 클라이언트 애플리케이션 유형(알려진 유형은 동적으로 결정됨, 예: 'cursor' , 'claude' , 'windsurf' ). config_file_path 와 함께 사용할 수 없습니다. 표준 클라이언트 설치에 사용하세요.
  • config_file_path (문자열, 선택 사항): 대상 JSON 구성 파일에 대한 절대 경로 또는 ~ (홈 디렉터리)로 시작하는 경로(예: /path/to/custom/mcp.json 또는 ~/custom/mcp.json ). client_type 과 함께 사용할 수 없습니다. 비표준 위치 또는 사용자 지정 클라이언트에 사용하세요.
  • mcp_definition (객체, 선택 사항): 서버 구성을 정의합니다. 생략하거나 특정 필드가 누락된 경우, server_id 기반으로 MCPfinder 레지스트리에서 기본값을 가져옵니다.
    • command (문자열 배열, 선택 사항): 명령과 인수(예: ["npx", "-y", "my-mcp-package"] ). 생략하거나 아래에 env / workingDirectory 만 제공하면 기본 명령을 레지스트리에서 가져옵니다.
    • env (객체, 선택 사항): 환경 변수(예: {"API_KEY": "YOUR_KEY"} ). command 생략되면 기본값과 병합됩니다.
    • workingDirectory (문자열, 선택 사항): 서버 프로세스의 작업 디렉토리입니다. command 가 생략되면 defaults와 병합됩니다.
• 출력: 성공 또는 오류 메시지.
• 참고: JSON 파일( mcpServers 또는 servers ) 내 이 서버 구성을 저장하는 데 사용되는 키는 server_id 를 통해 얻은 서버의 등록된 URL을 기반으로 자동 생성됩니다. 제공된 server_id URL에서 적절한 키를 얻을 수 없는 경우 대체 키로 사용됩니다. 이 도구는 기존 파일 구조를 기반으로 mcpServers 또는 servers 어떤 것을 최상위 키로 사용할지 자동으로 감지하며, 기본값은 mcpServers 입니다.

4. remove_mcp_server_config

• 설명: 클라이언트 애플리케이션의 로컬 구성 파일에서 특정 MCP 서버에 대한 구성을 제거합니다. client_type 또는 config_file_path중 하나를 제공해야 합니다. 제공된 server_id 서버 추가 시 사용된 구성 키 이름과 일치해야 합니다(일반적으로 서버 URL에서 파생됨, add_mcp_server_config 참고 참조).
• 입력 스키마:
  • server_id (문자열, 필수 ): 제거할 서버 구성 항목의 고유 식별자(구성 키 이름)입니다.
  • client_type (문자열, 선택 사항): 클라이언트 애플리케이션의 유형(알려진 유형은 동적으로 결정됨, 예: 'cursor' , 'claude' , 'windsurf' ). config_file_path 와 상호 배타적입니다.
  • config_file_path (문자열, 선택 사항): 대상 JSON 구성 파일에 대한 절대 경로 또는 ~ (홈 디렉터리)로 시작하는 경로입니다. client_type 과 함께 사용할 수 없습니다.
• 출력: 항목이 발견되어 제거되었는지 여부를 나타내는 성공 또는 오류 메시지입니다.

보안 고려 사항

add_mcp_server_config 및 remove_mcp_server_config 도구는 사용자 로컬 시스템의 파일을 수정합니다. 이 서버 자체는 권한 검사를 수행하지 않으며, 보안 적용을 위해 호출하는 클라이언트에 전적으로 의존합니다.

기여하다

기여를 원하시면 mcpfinder(dot}dev[at}domainsbyproxy{dot]com으로 연락해 주세요.

특허

이 프로젝트는 GNU Affero General Public License v3.0에 따라 라이선스가 부여되었습니다. 자세한 내용은 LICENSE 파일을 참조하세요.

즉, 자유롭게 사용(상업적 사용 포함), 수정 및 공유할 수 있습니다. 단, 수정된 버전을 실행하는 경우 해당 버전을 공개적으로 공유해야 합니다.