mcp_server

huntkil/mcp_server

3.1

If you are the rightful owner of mcp_server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The MCP Productivity Server is a cross-platform integration server that manages various productivity tools.

Tools
5
Resources
0
Prompts
0

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개