erickwendel-contributions-mcp

Erick Wendel의 기여 내역을 다양한 플랫폼에서 조회할 수 있는 도구를 제공하는 MCP(Model Context Protocol) 서버입니다. Claude, Cursor 등에서 자연어를 사용하여 강연, 블로그 게시물, 동영상을 조회할 수 있습니다. 이 프로젝트는 Cursor IDE의 기본 에이전트(평가판 버전)를 사용하여 구축되었습니다.

빠른 시작

설치 없이 Claude Desktop이나 Cursor에서 이 MCP 서버를 직접 사용하세요:

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}

다음 설정을 추가하세요:

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

• Cursor: ~/.cursor/mcp.json

Related MCP server: mintlify-mcp

사용 가능한 도구

이 MCP 서버는 다음과 같은 기능을 제공합니다:

도구

• get-talks: 선택적 필터링을 통해 페이지네이션된 강연 목록을 가져옵니다.

  • ID, 제목, 언어, 도시, 국가 및 연도별 필터링 지원

  • 언어, 국가 또는 도시별로 그룹화된 개수 반환 가능

• get-posts: 선택적 필터링 및 페이지네이션을 통해 게시물을 가져옵니다.

  • ID, 제목, 언어 및 포털별 필터링 지원

• get-videos: 선택적 필터링 및 페이지네이션을 통해 동영상을 가져옵니다.

  • ID, 제목 및 언어별 필터링 지원

• check-status: API가 활성화되어 응답하는지 확인합니다.

프롬프트

• find-content: 유형, 주제 및 언어별로 특정 콘텐츠를 찾는 쿼리 생성

• summarize-activity: 연도별 콘텐츠 활동 요약 생성

리소스

• erickwendel://about: 서버 정보 및 기능 메타데이터

• erickwendel://statistics: 콘텐츠 통계 및 사용 가능한 쿼리

AI 도구와의 통합

MCP 서버 기능 검사

MCP Inspector를 사용하여 이 MCP 서버의 기능을 검사할 수 있습니다:

npm run inspect

여기에서 사용 가능한 모든 도구, 매개변수 및 사용 방법을 확인할 수 있습니다.

설정

1. Node.js v20 이상을 사용 중인지 확인하세요.

node -v
# v20.x.x or higher

2. 이 저장소를 복제합니다:

git clone https://github.com/erickwendel/erickwendel-contributions-mcp.git
cd erickwendel-contributions-mcp

3. 의존성을 설치합니다:

npm ci

4. 서버를 실행합니다:

npm start

AI 도구와의 통합

Cursor 설정

~/.cursor/mcp.json에 다음 설정을 추가하세요:

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}

왼쪽 하단 드롭다운에서 "Agent"를 선택하여 Cursor 채팅이 에이전트 모드인지 확인한 다음, "how many videos were published about JavaScript in 2024"라고 질문해 보세요:

로컬 개발

로컬 개발 시에는 프로젝트의 절대 경로를 사용하세요:

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "node",
      "args": ["--experimental-strip-types", "ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
    }
  }
}

Claude Desktop 설정

1. Claude 설정으로 이동합니다.

2. 개발자(Developer) 탭을 클릭합니다.

3. 설정 편집(edit config)을 클릭합니다.

4. 코드 편집기에서 설정을 엽니다.

5. ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)에 다음 설정을 추가합니다:

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}

로컬 개발

로컬 개발 시에는 프로젝트의 절대 경로를 사용하세요:

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "node",
      "args": ["--experimental-strip-types", "ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
    }
  }
}

Ollama를 사용하는 MCPHost (무료 대안)

Claude Desktop이나 Cursor에 액세스할 수 없는 경우, 무료 대안으로 Ollama와 함께 MCPHost를 사용할 수 있습니다.

1. MCPHost 설치:

go install github.com/mark3labs/mcphost@latest

2. 설정 파일 생성 (예: ./mcp.jsonc):

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}

3. Ollama로 실행:

ollama pull MODEL_NAME
mcphost --config ./mcp.jsonc -m ollama:MODEL_NAME

로컬 개발

로컬 개발 시 설정을 업데이트하세요:

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "node",
      "args": ["--experimental-strip-types", "ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
    }
  }
}

쿼리 예시

Claude, Cursor 또는 모든 MCP 클라이언트에 질문할 수 있는 쿼리 예시는 다음과 같습니다:

1. "How many talks were given in 2023?"

2. "Show me talks in Spanish"

3. "Find posts about WebXR"

개발

특징

• Model Context Protocol (MCP)로 구축됨

• 전체 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

테스트

테스트 모음을 실행하려면:

npm test

감시 모드(watch)로 개발하려면:

npm run test:dev

기여

기여를 환영합니다! 자유롭게 Pull Request를 제출해 주세요.

작성자

Erick Wendel

라이선스

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