MCP Server

MCP 서버

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

• 🛠️ 이 서버는 어떤 도구를 제공하나요?
• 🏎️ 어떻게 실행할 수 있나요?
  • 🐋 Docker 사용 (권장)
  • 💻 지역적으로 실행
• 🔌 연결 방법
• 📚 MCP에 대해 자세히 알아보세요
• 📄 라이센스

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

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

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

🐋 Docker 사용 (권장)

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

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

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

   SSE_HOST 와 SSE_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 이라고 가정):

💻 지역적으로 실행

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 환경 변수는 항상 필수입니다.

🔌 연결 방법

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

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

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

• MCP 사양
• MCP 파이썬 SDK
• MCP 예제 서버

📄 라이센스

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