위키피디아 MCP 서버

위키백과에서 정보를 검색하여 대규모 언어 모델(LLM)에 맥락을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 도구는 AI 비서가 위키백과에서 사실 정보를 검색하여 신뢰할 수 있는 출처를 기반으로 답변을 작성할 수 있도록 지원합니다.

개요

위키백과 MCP 서버는 표준화된 모델 컨텍스트 프로토콜(MCP) 인터페이스를 통해 위키백과 정보에 대한 실시간 접근을 제공합니다. 이를 통해 LLM은 위키백과에서 정확하고 최신 정보를 직접 검색하여 응답을 향상시킬 수 있습니다.

검증됨

특징

• 위키피디아 검색 : 특정 쿼리와 일치하는 문서 찾기

• 기사 내용 검색 : 모든 정보가 포함된 전체 기사 텍스트를 가져옵니다.

• 기사 요약 : 기사의 간결한 요약을 받으세요

• 섹션 추출 : 기사에서 특정 섹션 검색

• 링크 검색 : 관련 주제에 대한 기사 내 링크 찾기

• 관련 주제 : 특정 기사와 관련된 주제를 알아보세요

• 다국어 지원 : 다양한 언어로 위키피디아에 접속하세요

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 wikipedia-mcp를 자동으로 설치하려면:

지엑스피1

pipx 사용(권장)

가상 환경 사용

출처에서

용법

서버 실행

Claude Desktop 구성

Claude Desktop 구성 파일에 다음을 추가하세요.

구성 파일의 위치:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• 윈도우: %APPDATA%/Claude/claude_desktop_config.json

• 리눅스: ~/.config/Claude/claude_desktop_config.json

사용 가능한 MCP 도구

Wikipedia MCP 서버는 LLM이 Wikipedia와 상호 작용할 수 있도록 다음과 같은 도구를 제공합니다.

search_wikipedia

질의어와 일치하는 문서를 위키피디아에서 검색합니다.

매개변수:

• query (문자열): 검색어

• limit (정수, 선택 사항): 반환할 최대 결과 수(기본값: 10)

보고:

• 제목, 스니펫 및 메타데이터가 포함된 검색 결과 목록

get_article

위키피디아 문서의 전체 내용을 알아보세요.

매개변수:

• title (문자열): 위키피디아 문서의 제목

보고:

• 텍스트, 요약, 섹션, 링크 및 카테고리를 포함한 기사 콘텐츠

get_summary

위키피디아 문서의 간략한 요약을 받아보세요.

매개변수:

• title (문자열): 위키피디아 문서의 제목

보고:

• 기사의 텍스트 요약

get_sections

위키피디아 문서의 섹션을 가져옵니다.

매개변수:

• title (문자열): 위키피디아 문서의 제목

보고:

• 콘텐츠가 포함된 기사 섹션의 구조화된 목록

get_links

위키피디아 문서에 포함된 링크를 가져옵니다.

매개변수:

• title (문자열): 위키피디아 문서의 제목

보고:

• 다른 위키피디아 문서에 대한 링크 목록

get_related_topics

링크와 카테고리를 기반으로 위키피디아 문서와 관련된 주제를 가져옵니다.

매개변수:

• title (문자열): 위키피디아 문서의 제목

• limit (정수, 선택 사항): 관련 주제의 최대 개수(기본값: 10)

보고:

• 관련 정보가 포함된 관련 주제 목록

예시 프롬프트

서버가 실행되고 Claude Desktop으로 구성되면 다음과 같은 프롬프트를 사용할 수 있습니다.

• "위키피디아 정보를 이용해 양자 컴퓨팅에 대해 설명해 보세요."

• "위키피디아를 기반으로 인공지능의 역사를 요약해 보세요."

• "위키피디아에서는 기후 변화에 대해 무엇이라고 말하나요?"

• "머신 러닝과 관련된 위키피디아 문서를 찾으세요."

• "위키피디아에서 신경망에 대한 기사의 소개 부분을 찾아주세요."

MCP 리소스

서버는 또한 MCP 리소스(HTTP 엔드포인트와 유사하지만 MCP용)를 제공합니다.

• search/{query} : 쿼리와 일치하는 문서를 위키피디아에서 검색합니다.

• article/{title} : 위키피디아 문서의 전체 내용을 가져옵니다.

• summary/{title} : 위키피디아 문서의 요약을 가져옵니다.

• sections/{title} : 위키피디아 문서의 섹션을 가져옵니다.

• links/{title} : 위키피디아 문서의 링크를 가져옵니다

개발

지역 개발 설정

프로젝트 구조

• wikipedia_mcp/ : 메인 패키지

  • __main__.py : 패키지의 진입점

  • server.py : MCP 서버 구현

  • wikipedia_client.py : 위키피디아 API 클라이언트

  • api/ : API 구현

  • core/ : 핵심 기능

  • utils/ : 유틸리티 함수

문제 해결

일반적인 문제

• 연결 오류 : claude_desktop_config.json의 명령이 올바른지 확인하세요.

• 기사를 찾을 수 없습니다 : 기사 제목의 정확한 철자를 확인하세요

• 속도 제한 : Wikipedia API에는 속도 제한이 있습니다. 요청 사이에 지연을 추가하는 것을 고려하세요.

• 대용량 문서 : 일부 위키백과 문서는 매우 커서 토큰 제한을 초과할 수 있습니다.

모델 컨텍스트 프로토콜(MCP) 이해

모델 컨텍스트 프로토콜(MCP)은 기존 HTTP API가 아니라 LLM과 외부 도구 간의 통신을 위한 특수 프로토콜입니다. 주요 특징은 다음과 같습니다.

• 통신을 위해 stdio(표준 입력/출력) 또는 SSE(서버에서 보낸 이벤트)를 사용합니다.

• AI 모델 상호 작용을 위해 특별히 설계되었습니다.

• 도구, 리소스 및 프롬프트에 대한 표준화된 형식을 제공합니다.

• Claude 및 기타 MCP 호환 AI 시스템과 직접 통합됩니다.

Claude Desktop은 MCP 클라이언트 역할을 하며, 이 서버는 Claude가 Wikipedia 정보에 접근하는 데 사용할 수 있는 도구와 리소스를 제공합니다.

기여하다

기여를 환영합니다! 자세한 내용은 CONTRIBUTING.md를 참조하세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

저자와 연결

• 🌐 포트폴리오: ravikumar-dev.me

• 📝 블로그: Medium

• 💼 LinkedIn: in/ravi-kumar-e

• 🐦 트위터: @Ravikumar_d3v