hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Converts scraped web content into markdown format for easier processing by Claude
Explicitly mentioned as an example website whose content can be fetched and summarized using the web_scrape tool
Provides a UI for connecting to and testing MCP servers, including viewing available tools and executing them

MCP 웹 도구 서버

웹 관련 작업을 위한 도구를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 LLM은 표준화된 도구를 통해 웹 콘텐츠와 상호 작용할 수 있습니다.

현재 도구

web_scrape : r.jina.ai를 접두사로 사용하도록 URL을 변환하고 마크다운 콘텐츠를 반환합니다.

설치

이 저장소를 복제하세요:지엑스피1
필요한 종속성을 설치하세요:
pip install -r requirements.txt
또는 더 빠른 설치를 위해 uv를 사용할 수 있습니다.
uv pip install -r requirements.txt

서버 및 UI 실행

이 저장소에는 MCP 서버나 Streamlit UI를 실행하는 데 편리한 스크립트가 포함되어 있습니다.

실행 스크립트 사용

macOS/Linux의 경우:

# Run the server with stdio transport (default)
./run.sh server

# Run the server with SSE transport
./run.sh server --transport sse --host localhost --port 5000

# Run the Streamlit UI
./run.sh ui

Windows의 경우:

# Run the server with stdio transport (default)
run.bat server

# Run the server with SSE transport
run.bat server --transport sse --host localhost --port 5000

# Run the Streamlit UI
run.bat ui

수동 실행

또는 서버를 직접 실행할 수 있습니다.

stdio 사용(기본값)

python server.py

SSE 사용

python server.py --transport sse --host localhost --port 5000

이렇게 하면 MCP 연결을 허용하는 localhost:5000 에서 HTTP 서버가 시작됩니다.

Streamlit UI를 수동으로 실행하려면:

streamlit run streamlit_app.py

MCP Inspector로 테스트

MCP Inspector는 MCP 서버를 테스트하고 디버깅하는 도구입니다. 다음과 같은 방법으로 서버와 상호 작용할 수 있습니다.

MCP 검사기 설치:
npm install -g @modelcontextprotocol/inspector
서버에서 검사기를 실행하세요.
npx @modelcontextprotocol/inspector python server.py
Inspector 인터페이스를 사용하여 example.com 과 같은 URL을 제공하고 반환된 마크다운 콘텐츠를 확인하여 web_scrape 도구를 테스트합니다.

데스크톱용 Claude와 통합

Claude for Desktop과 함께 이 서버를 사용하려면:

Claude for Desktop이 설치되어 있는지 확인하세요.
Claude for Desktop 구성 파일을 엽니다.
- Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
다음 구성을 추가합니다(필요에 따라 경로를 조정합니다):

{
  "mcpServers": {
    "web-tools": {
      "command": "python",
      "args": [
        "/absolute/path/to/MCP/server.py"
      ]
    }
  }
}

데스크톱에서 Claude를 다시 시작합니다.
이제 Claude 인터페이스에서 web_scrape 도구를 사용할 수 있습니다. Claude에게 웹사이트에서 콘텐츠를 가져오도록 요청하면 Claude가 이 도구를 사용합니다.

사용 예

Claude와 통합하면 다음과 같은 질문을 할 수 있습니다.

"example.com 홈페이지에는 무엇이 있나요?"
"mozilla.org에서 콘텐츠를 가져와서 요약해 줄 수 있나요?"
"wikipedia.org/wiki/Model_Context_Protocol에서 내용을 가져와서 설명해 주세요."

Claude는 web_scrape 도구를 사용하여 콘텐츠를 가져와 응답으로 제공합니다.

더 많은 도구 추가

이 서버에 더 많은 도구를 추가하려면:

tools/ 디렉토리에 새로운 Python 파일을 만듭니다(예: tools/new_tool.py ).
기존 도구와 유사한 패턴을 따라 도구 기능을 구현합니다.
server.py 에 도구를 가져와서 MCP 서버에 등록합니다.

# Import your new tool
from tools.new_tool import new_tool_function

# Register the tool with the MCP server
@mcp.tool()
async def new_tool(param1: str, param2: int) -> str:
    """
    Description of what your tool does.
    
    Args:
        param1: Description of param1
        param2: Description of param2
        
    Returns:
        Description of return value
    """
    return await new_tool_function(param1, param2)

변경 사항을 적용하려면 서버를 다시 시작하세요.

Streamlit UI

이 저장소에는 Claude for Desktop에서 구성된 모든 MCP 서버에 연결하여 테스트할 수 있는 Streamlit 애플리케이션이 포함되어 있습니다.

Streamlit UI 실행

streamlit run streamlit_app.py

그러면 Streamlit 서버가 시작되고 UI가 있는 웹 브라우저가 열립니다.

특징

Claude for Desktop 구성 파일을 로드하고 구문 분석합니다.
구성된 모든 MCP 서버 보기
모든 서버에 연결하여 사용 가능한 도구를 확인하세요.
입력 매개변수를 제공하고 결과를 확인하여 테스트 도구 사용
사용 가능한 리소스 및 프롬프트 보기

용법

Streamlit 앱을 시작합니다
Claude for Desktop 구성 파일의 경로를 입력하세요(기본 경로는 미리 채워져 있습니다)
사용 가능한 모든 MCP 서버를 보려면 "서버 로드"를 클릭하세요.
서버 탭을 선택하고 "연결"을 클릭하여 해당 도구를 로드합니다.
도구를 선택하고 필요한 매개변수를 제공하세요
"실행"을 클릭하여 도구를 실행하고 결과를 확인하세요.

문제 해결

종속성 누락 : requirements.txt 에 있는 모든 종속성이 설치되어 있는지 확인하세요.
연결 문제 : 서버가 실행 중인지 확인하고 Claude for Desktop의 구성이 올바른 경로를 가리키는지 확인하세요.
도구 실행 오류 : 서버 출력에서 오류 메시지를 찾아보세요.
Streamlit UI 문제 : Streamlit이 제대로 설치되었고 구성 파일 경로가 올바른지 확인하세요.

특허

이 프로젝트는 MIT 라이선스에 따라 제공됩니다. 자세한 내용은 라이선스 파일을 참조하세요.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

LLM이 표준화된 도구를 통해 웹 콘텐츠와 상호 작용할 수 있도록 하는 모델 컨텍스트 프로토콜 서버로, 현재 웹 스크래핑 기능을 지원합니다.

Related Resources

Reddit Discussion about this server

MCP Web Tools Server