MCP Server

GPL 3.0
2
  • Linux
  • Apple

Integrations

  • Allows converting web pages to markdown format for easier reading and processing by AI assistants

  • Integrates with SearXNG's search API to provide web search functionality, enabling current information retrieval, specific resource discovery, and calculations

MCP 서버

AI 비서에게 더욱 효과적으로 도움을 줄 수 있는 기능을 제공하세요. 이 서버를 통해 AI 비서가 웹사이트에 안전하게 접속하고 웹을 검색할 수 있으며, 진행 상황에 대한 명확한 피드백과 문제 발생 시 유용한 오류 메시지를 제공합니다.

🛠️ 이 서버는 어떤 도구를 제공하나요?

이 서버는 AI 도우미가 실제 문제를 해결하는 데 도움이 되는 두 가지 강력한 도구를 제공합니다.

도구그것이 할 수 있는 일
찾다SearXNG를 통해 웹에서 최신 정보, 특정 리소스를 검색하거나 계산을 수행하세요.
편물웹사이트에 접속하여 콘텐츠를 처리합니다. 페이지를 마크다운으로 변환하여 읽기 쉽게 만들고, 원본 콘텐츠를 가져오거나 링크를 추출할 수 있습니다.

🏎️ 어떻게 실행할 수 있나요?

🐋 Docker 사용 (권장)

안전하고 간편한 사용을 위해 서버는 Docker 컨테이너에서 실행됩니다. 시작 방법은 다음과 같습니다.

  1. 아직 Docker를 설치하지 않았다면 설치하세요 .
  2. 다음을 사용하여 docker-compose.yml 이라는 파일을 만듭니다.지엑스피1

    중요 : SearXNG 인스턴스의 검색 API 엔드포인트를 가리키는 SEARXNG_QUERY_URL 환경 변수를 제공 해야 합니다 (일반적으로 / 또는 /search 로 끝남).

    SSE_HOSTSSE_PORT 설정하면 네트워크 모드(서버 전송 이벤트)가 활성화됩니다. 이는 LibreChat과 같은 다중 컨테이너 설정에 권장됩니다. 생략하면 서버는 표준 I/O를 사용합니다.

  3. docker compose up -d 실행하여 서버 컨테이너(및 선택적으로 SearXNG)를 시작합니다.

대부분의 사람들은 이것을 다음 중 하나와 함께 사용합니다.

  • Claude Desktop - stdio를 통해 직접 연결합니다( docker-compose.yml 에서 SSE_HOST / SSE_PORT 생략).
  • LibreChat - SSE를 통해 네트워크에 연결됩니다.

LibreChat의 경우 librechat.yaml 에 다음을 추가합니다( SSE_PORT=8080 이라고 가정):

mcpServers: mcp-server: iconPath: "/path/to/icon.png" # Optional: Custom icon label: "MCP Web/Search" # Optional: Custom label shown in UI type: sse url: http://mcp-server:8080/sse # Adjust host/port if needed

💻 지역적으로 실행

  1. uv 설치(Python 3.13 이상 필요):
    curl -LsSf https://astral.sh/uv/install.sh | sh

    참고: 이미 uv 설치되어 있는 경우 uv self update 로 업데이트하세요.

  2. 가상 환경을 만들고 활성화하세요.
    uv venv source .venv/bin/activate # Linux/macOS # or .venv\Scripts\activate # Windows
  3. 잠금 파일에서 종속성을 설치합니다.
    uv sync
  4. 필요한 환경 변수를 설정하세요:
    # Required: URL for your SearXNG instance's Search API export SEARXNG_QUERY_URL="http://your-searxng-instance.local:8080" # Optional: Custom User-Agent export USER_AGENT="CustomAgent/1.0"
  5. 서버를 실행합니다:
    # For network (SSE) mode (e.g., for LibreChat) mcp-server --sse-host 0.0.0.0 --sse-port 3001 # For direct stdio mode (e.g., for Claude Desktop) mcp-server

사용 가능한 인수:

  • --sse-host : SSE 수신 주소(예: 0.0.0.0 ). SSE 모드를 활성화합니다.
  • --sse-port : SSE 수신 포트(예: 3001 ). SSE 모드를 활성화합니다.
  • --user-agent : 사용자 정의 사용자 에이전트 문자열( USER_AGENT 환경 변수보다 우선함).

참고 : --sse-host--sse-port 모두 제공되지 않고 SSE_HOST / SSE_PORT 환경 변수가 설정되지 않은 경우, 서버는 기본적으로 stdio 모드로 설정됩니다. SEARXNG_QUERY_URL 환경 변수는 항상 필수입니다.

🔌 연결 방법

서버에 연결하는 방법은 두 가지가 있습니다.

방법그것이 의미하는 바언제 사용해야 하나요?
네트워크 연결(SSE)서버는 네트워크 포트에서 연결을 수신합니다.LibreChat이나 다른 네트워크 클라이언트에 가장 적합합니다.
직접 연결(stdio)서버는 표준 입출력을 통해 직접 통신합니다.로컬 테스트나 Claude Desktop에 유용합니다.

📚 MCP에 대해 자세히 알아보세요

시작하는 데 도움이 되는 몇 가지 리소스를 소개합니다.

📄 라이센스

이 프로젝트는 GPLv3 라이선스를 따릅니다. 자세한 내용은 LICENSE 파일을 참조하세요.

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

클로드와 같은 AI 도우미가 안전하게 Python 코드를 실행하고 웹사이트에 접속하여 AI가 더 잘 이해할 수 있도록 데이터를 처리하고 유용한 오류 메시지를 제공할 수 있는 서버입니다.

  1. 🛠️ What tools does this server offer?
    1. 🏎️ How can I run it?
      1. 🐋 Using Docker (recommended)
      2. 💻 Running locally
    2. 🔌 How to connect
      1. 📚 Learn more about MCP
        1. 📄 License
          ID: nc2bikdnkd