에릭웬델-기여-MCP
다양한 플랫폼에서 Erick Wendel의 기여 내용을 쿼리하는 도구를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. Claude, Cursor 또는 이와 유사한 도구를 사용하여 자연어를 사용하여 강연, 블로그 게시물, 비디오를 쿼리할 수 있습니다. 이 프로젝트는 Cursor IDE와 기본 에이전트(체험판)를 사용하여 구축되었습니다.
이 MCP 서버는 Smithery 에서도 직접 통합이 가능합니다.
사용 가능한 도구
이 MCP 서버는 API와 상호 작용하기 위한 다음과 같은 도구를 제공합니다.
get-talks : 선택적 필터링을 사용하여 페이지별로 정리된 토크 목록을 검색합니다.- ID, 제목, 언어, 도시, 국가 및 연도별 필터링 지원
- 언어, 국가 또는 도시별로 그룹화된 개수를 반환할 수 있습니다.
get-posts : 선택적 필터링 및 페이지 매김을 사용하여 게시물을 가져옵니다.get-videos : 선택적 필터링 및 페이지 매김을 사용하여 비디오를 검색합니다.check-status : API가 활성 상태이고 응답하는지 확인합니다.
AI 도구와의 통합
MCP 서버 기능 검사
Smithery를 사용하여 이 MCP 서버의 기능을 검사할 수 있습니다.
지엑스피1
여기에는 사용 가능한 모든 도구, 매개변수, 사용 방법이 표시됩니다.
설정
- Node.js v23+를 사용하고 있는지 확인하세요.
- 이 저장소를 복제하세요:
git clone https://github.com/erickwendel/erickwendel-contributions-mcp.git
cd erickwendel-contributions-mcp
- 종속성 복원:
AI 도구와의 통합
커서 설정
- 커서 설정 열기
- MCP 섹션으로 이동
- "새 MCP 서버 추가"를 클릭하세요.
- 서버를 구성하세요:
Name = erickwendel-contributions
Type = command
Command = node ABSOLUTE_PATH_TO_PROJECT/src/index.ts
Name = erickwendel-contributions
Type = command
Command = npm exec -- @smithery/cli@latest run @ErickWendel/erickwendel-contributions-mcp
또는 ~/.cursor/mcp.json 에 있는 커서의 글로벌 MCP 파일에서 직접 구성하고 다음을 추가합니다.
{
"mcpServers": {
"erickwendel-contributions": {
"command": "node",
"args": ["ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
}
}
}
또는 Smithery에서 실행하는 것을 선호하는 경우
{
"mcpServers": {
"erickwendel-contributions": {
"command": "npm",
"args": [
"exec",
"--",
"@smithery/cli@latest",
"run",
"@ErickWendel/erickwendel-contributions-mcp"
]
}
}
}
- 왼쪽 하단 드롭다운에서 "에이전트"를 선택하여 커서 채팅이 에이전트 모드인지 확인하세요.
- 채팅으로 가서 "2024년에 JavaScript에 대한 영상이 몇 개나 게시됐나요?"라고 물어보세요.
클로드 데스크탑 설정
Smithery를 통해 설치
Smithery를 통해 Claude Desktop용 Erick Wendel Contributions을 자동으로 설치하려면:
npx -y @smithery/cli install @ErickWendel/erickwendel-contributions-mcp --client claude
참고 : 현재 Claude용 Smithery CLI 설치에 문제가 있습니다. 문제가 해결될 때까지 아래 수동 설치 방법을 사용해 주세요.
수동 설정
- Claude 설정으로 이동
- 개발자 탭을 클릭하세요
- 편집 구성을 클릭하세요
- 코드 편집기에서 구성을 엽니다.
- Claude Desktop 구성에 다음 구성을 추가하세요.
{
"mcpServers": {
"erickwendel-contributions": {
"command": "node",
"args": ["ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
}
}
}
또는 Smithery에서 실행하는 것을 선호하는 경우
{
"mcpServers": {
"erickwendel-contributions": {
"command": "npm",
"args": [
"exec",
"--",
"@smithery/cli@latest",
"run",
"@ErickWendel/erickwendel-contributions-mcp"
]
}
}
}
- 파일을 저장하고 Claude Desktop을 다시 시작하세요.
- 개발자 탭을 다시 열고 다음과 같이 "실행 중" 상태인지 확인하세요.
- 채팅에 가서 "RAG에 대한 영상이 있나요?"라고 물어보세요.
MCPHost를 사용한 무료 대안
Claude Desktop이나 Cursor를 사용할 수 없는 경우, Ollama와 함께 제공되는 MCPHost를 무료 대안으로 사용할 수 있습니다. MCPHost는 대규모 언어 모델(LML)이 MCP 서버와 상호 작용할 수 있도록 지원하는 CLI 도구입니다.
- MCPHost 설치:
go install github.com/mark3labs/mcphost@latest
- 구성 파일을 만듭니다(예: ./mcp.jsonc ):
{
"mcpServers": {
"erickwendel-contributions": {
"command": "node",
"args": ["ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
}
}
}
또는 Smithery에서 실행하는 것을 선호하는 경우
{
"mcpServers": {
"erickwendel-contributions": {
"command": "npm",
"args": [
"exec",
"--",
"@smithery/cli@latest",
"run",
"@ErickWendel/erickwendel-contributions-mcp"
]
}
}
}
- 원하는 Ollama 모델로 MCPHost를 실행하세요.
ollama pull MODEL_NAME
mcphost --config ./mcp.jsonc -m ollama:MODEL_NAME
예제 쿼리
다음은 Claude, Cursor 또는 MCP 클라이언트에게 물어볼 수 있는 몇 가지 질문의 예입니다.
- "2023년에는 몇 번의 강연이 있었나요?"
- "스페인어로 된 강의를 보여주세요"
- "WebXR에 대한 게시물 찾기"
개발
특징
- 모델 컨텍스트 프로토콜(MCP)로 구축됨
- TypeScript 및 Zod 스키마 검증을 통한 유형 안전
- 변환 없이 Node.js에서 기본 TypeScript 지원
- GenQL을 사용하여 생성된 SDK
- 관심사 분리를 통한 모듈형 아키텍처
- 쉬운 통합을 위한 표준 I/O 전송
- 구조화된 오류 처리
- Claude Desktop, Cursor 및 MCPHost 와 호환(무료 대안)
참고: 이 프로젝트는 작년에 추가된 기본 TypeScript 지원을 사용하므로 Node.js v23 이상이 필요합니다.
건축학
코드베이스는 모듈형 구조를 따릅니다.
src/
├── config/ # Configuration settings
├── types/ # TypeScript interfaces and types
├── tools/ # MCP tool implementations
├── utils/ # Utility functions
├── services/ # API service layer
└── index.ts # Main entry point
테스트
테스트 모음을 실행하려면:
시계를 사용한 개발 모드의 경우:
기여하다
기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.
작가
에릭 웬델
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.