간단한 MCP 도구 서버
SSE 전송을 사용하여 웹사이트 페칭 도구를 제공하는 간단한 MCP 서버입니다.
요구 사항
Python 3.10 이상(Python 3.13에서 테스트됨)
Related MCP server: MCP Server Fetch TypeScript
설치
지엑스피1
MCP Python SDK 문서
MCP Python SDK 설명서는 작은 파일로 분할되어 docs/ 디렉터리에 정리되었습니다. 이러한 구조 덕분에 AI 에이전트가 SDK를 더 쉽게 탐색하고 이해할 수 있습니다. 설명서에는 다음 내용이 포함되어 있습니다.
핵심 개념(서버, 리소스, 도구 등)
다양한 모드에서 MCP 서버 실행
예시 및 고급 사용법
그리고 더 많은 것들!
용법
이 패키지는 MCP 서버를 관리하기 위한 여러 명령을 갖춘 명령줄 인터페이스(CLI)를 제공합니다.
서버 시작
기본 포트(7000)에서 서버를 시작하거나 사용자 지정 포트를 지정합니다.
# Using default port (7000)
python -m mcp_simple_tool start
# Using custom port
python -m mcp_simple_tool start --port 8000서버 관리
# Check if server is running
python -m mcp_simple_tool check [--port PORT]
# Stop the server
python -m mcp_simple_tool stop [--port PORT]
# Restart the server (stop and start)
python -m mcp_simple_tool restart [--port PORT]재시작 명령은 다음을 수행합니다.
지정된 포트에서 기존 서버를 중지합니다.
백그라운드에서 새 서버를 시작합니다
서버가 응답할 때까지 기다리세요
server.log에 로그 출력
CLI 빠른 참조
명령 | 목적 |
| 서버를 시작합니다 |
| 서버를 중지합니다 |
| 건강 검진 |
| 정지 및 시작 |
서버 도구
서버는 다음 도구를 제공합니다.
fetch : 원격 HTTP 페처 - 절대 URL을 제공하고 페이지 텍스트를 반환합니다.
url: 가져올 웹사이트의 URL (필수)
search_docs : SDK 문서 전반에 걸친 의미 검색; 상위 k 발췌문을 반환합니다.
query: 검색어 또는 질문 (필수)k: 반환할 상위 일치 항목 수(선택 사항, 기본값 = 3)
get_content :
search_docs에서 반환된 모든 일치 항목에 대한 전체 로컬 파일을 가져옵니다.file: 문서에 대한 상대 경로(필수)
개발 설정
개발을 위해 추가 도구를 설치하세요.
pip install -e .
pip install -r requirements.txt일반적인 작업에는 Makefile을 사용하세요.
# Format code
make fmt
# Run linters
make lint
# Run tests
make test테스트 스위트에는 모든 테스트, 특히 SSE 엔드포인트에서 중단(hang)을 방지하기 위해 20초의 시간 제한이 기본으로 설정되어 있습니다. 개별 테스트의 경우 @pytest.mark.timeout(seconds) 데코레이터를 사용하여 더 엄격한 시간 제한을 지정할 수 있습니다.
의미 검색 인덱스
search_docs 도구의 경우 벡터 인덱스를 수동으로 빌드하거나 다시 빌드할 수 있습니다.
# Build or rebuild the semantic search index
python scripts/build_doc_index.py인덱스가 존재하지 않으면 첫 번째 도구 사용 시 자동으로 인덱스가 생성됩니다.
프로젝트 아키텍처
mcp_simple_tool/
__init__.py # Package initialization
__main__.py # Entry point when run as module
cli.py # Command-line interface
server/ # Server implementation
__init__.py # Server package initialization
app.py # ASGI application setup
config.py # Configuration settings
handlers.py # Tool implementations
http.py # HTTP utilities
semantic_search/ # Semantic search functionality
__init__.py # Package initialization
indexing.py # Build and persist vector store
search.py # Load index and query helpers커서와 함께 사용
이 MCP 서버는 Cursor를 클라이언트로 사용하여 사용할 수 있습니다. 설정 방법은 다음과 같습니다.
터미널에서 서버를 실행합니다.
source venv/bin/activate
python -m mcp_simple_tool start
# or use the restart command
python -m mcp_simple_tool restart.cursor/mcp.json파일을 만들어 커서를 구성합니다.
{
"mcpServers": {
"website-fetcher-sse": {
"url": "http://localhost:7000/sse"
}
}
}커서를 사용할 때 프롬프트에 서버를 언급하세요.
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.