huntkil/mcp_server

MCP Productivity Server

Cursor AI 통합 MCP 서버 - 다양한 생산성 도구들을 통합 관리하는 크로스 플랫폼입니다.

🖥️ 지원 플랫폼

• ✅ Windows 11 (완전 지원) -
• ✅ Windows 10 (1909 이상)
• ✅ macOS (Intel/Apple Silicon)
• ✅ Linux (Ubuntu, CentOS 등)

🚀 주요 기능

📦 사용 가능한 플러그인

1. Obsidian - 노트 관리 및 검색

   • 노트 생성, 수정, 삭제
   • 태그 기반 검색
   • 데일리 노트 관리
   • 템플릿 기반 노트 생성

2. Weather - 날씨 정보 및 예보

   • 현재 날씨 조회
   • 위치별 날씨 정보
   • 날씨 설정 관리

3. Google Calendar - 일정 관리

   • 일정 생성, 수정, 삭제
   • 오늘의 일정 조회
   • 주간 일정 보기

4. Gmail - 이메일 관리

   • 이메일 발송
   • 최근 이메일 조회
   • 이메일 검색

5. Reddit - 서브레딧 모니터링 및 포스트 관리 ⭐ NEW

   • 서브레딧 포스트 조회
   • Reddit 검색
   • 인기 서브레딧 목록
   • 포스트 댓글 조회
   • 사용자 포스트 조회

🏗️ 프로젝트 구조

mcp_server_new/
├── src/
│   ├── index.ts                 # MCP 서버 메인 엔트리포인트
│   ├── http-server.ts           # HTTP 서버
│   ├── core/
│   │   ├── base-plugin.ts       # 플러그인 기본 인터페이스
│   │   └── plugin-manager.ts    # 플러그인 관리자
│   ├── plugins/
│   │   └── core/
│   │       ├── obsidian/        # Obsidian 플러그인
│   │       ├── weather/         # Weather 플러그인
│   │       ├── google-calendar/ # Google Calendar 플러그인
│   │       ├── gmail/           # Gmail 플러그인
│   │       └── reddit/          # Reddit 플러그인 ⭐
│   ├── utils/
│   │   └── file-system.ts       # 파일 시스템 유틸리티
│   └── types/
│       └── plugin-types.ts      # 플러그인 타입 정의
├── config/
│   └── credentials/             # API 키 및 설정 파일
├── dashboard/                   # React 대시보드
├── scripts/                     # 인증 스크립트
└── tests/                       # 테스트 파일

🚀 시작 방법

Windows 11 사용자 (권장)

Windows 11에서의 자세한 설정 방법은 ****를 참조하세요.

빠른 시작 (Windows):

# 자동 설정 및 설치
.\setup-windows.ps1

# 모든 서버 시작
.\start-all-servers.ps1

macOS/Linux 사용자

1. 의존성 설치

npm install
cd dashboard && npm install && cd ..

2. 설정 파일 생성

각 플러그인별 설정 파일을 config/credentials/ 디렉토리에 생성:

• config.json - 기본 설정
• google-token.json - Google Calendar/Gmail 토큰
• reddit-config.json - Reddit API 설정 ⭐

3. 프로젝트 빌드 및 실행

# 빌드
npm run build

# 모든 서버 시작 (MCP + HTTP + Dashboard)
./start-all-servers.sh

# 또는 개별 실행
npm start              # MCP 서버 (stdio)
npm run start:http     # HTTP 서버 (포트 4000)
cd dashboard && npm start  # 대시보드 (포트 3000)

🔧 MCP 도구

총 28개의 MCP 도구가 제공됩니다:

Obsidian (8개)

• obsidian_search_notes - 노트 검색
• obsidian_create_note - 노트 생성
• obsidian_get_daily_note - 데일리 노트
• obsidian_update_note - 노트 수정
• obsidian_search_by_tag - 태그 검색
• obsidian_get_backlinks - 백링크 조회
• obsidian_create_note_from_template - 템플릿 노트
• obsidian_get_graph - 그래프 데이터

Weather (3개)

• weather_get_current - 현재 날씨
• weather_get_forecast - 날씨 예보
• weather_set_location - 위치 설정

Google Calendar (6개)

• get_today_events - 오늘 일정
• get_week_events - 주간 일정
• create_event - 일정 생성
• update_event - 일정 수정
• delete_event - 일정 삭제
• get_event_details - 일정 상세

Gmail (5개)

• gmail_get_recent_emails - 최근 이메일
• gmail_send_email - 이메일 발송
• gmail_search_emails - 이메일 검색
• gmail_get_unread_count - 읽지 않은 이메일
• gmail_get_email_content - 이메일 내용

Reddit (6개) ⭐

• reddit_get_subreddit_posts - 서브레딧 포스트
• reddit_get_subreddit_info - 서브레딧 정보
• reddit_search_posts - 포스트 검색
• reddit_get_post_comments - 댓글 조회
• reddit_get_user_posts - 사용자 포스트
• reddit_get_trending_subreddits - 인기 서브레딧

📊 대시보드 기능

React 기반 웹 대시보드에서 다음 기능을 제공합니다:

• ✅ 실시간 모니터링: 모든 플러그인 상태 확인
• ✅ CRUD 작업: 이메일, 일정, 노트 생성/수정/삭제
• ✅ 검색 기능: 각 플러그인별 검색
• ✅ 모달 인터페이스: 직관적인 작업 수행
• ✅ 반응형 디자인: 모바일/데스크톱 지원

🧪 테스트

# 전체 테스트 실행
npm test

# 대시보드 테스트
cd dashboard && npm test

# API 테스트
node test-reddit.js

📝 설정 가이드

Reddit 플러그인 설정 ⭐

1. Reddit Apps에서 앱 생성
2. config/credentials/reddit-config.json 파일 생성
3. API 키 및 토큰 설정

자세한 설정 방법은 src/plugins/core/reddit/README.md 참조

🤝 기여

버그 리포트, 기능 제안, PR 모두 환영합니다!

📄 라이선스

MIT License

현재 버전: 1.0.0
지원 플러그인: 5개 (Obsidian, Weather, Google Calendar, Gmail, Reddit)
총 MCP 도구: 28개