MCP 서버

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

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

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

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

Related MCP server: MCP Python Toolbox

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

🐋 Docker 사용 (권장)

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

아직 Docker를 설치하지 않았다면 설치하세요 .
다음을 사용하여 docker-compose.yml 이라는 파일을 만듭니다.
지엑스피1
중요 : SearXNG 인스턴스의 검색 API 엔드포인트를 가리키는 SEARXNG_QUERY_URL 환경 변수를 제공 해야 합니다 (일반적으로 / 또는 /search 로 끝남).
SSE_HOST 와 SSE_PORT 설정하면 네트워크 모드(서버 전송 이벤트)가 활성화됩니다. 이는 LibreChat과 같은 다중 컨테이너 설정에 권장됩니다. 생략하면 서버는 표준 I/O를 사용합니다.
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

💻 지역적으로 실행

uv 설치(Python 3.13 이상 필요):
```
curl -LsSf https://astral.sh/uv/install.sh | sh
```
참고: 이미 uv 설치되어 있는 경우 uv self update 로 업데이트하세요.

가상 환경을 만들고 활성화하세요.

uv venv
source .venv/bin/activate  # Linux/macOS
# or
.venv\Scripts\activate     # Windows

잠금 파일에서 종속성을 설치합니다.
```
uv sync
```

필요한 환경 변수를 설정하세요:

# 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"

서버를 실행합니다:

# 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에 유용합니다.