MCP 服务器

notion_summary_server

MCP server that automatically saves summaries of AI papers or stock articles to a Notion database.

README

notion_summary_server

AI 논문 요약, 주식 리서치, 공부노트, 주간 브리핑을 Notion 데이터베이스에 자동 저장하는 MCP 서버.

⚠️ Notion 관련 작업(논문 저장, 주식 리서치, 주간 브리핑)은 이 폴더를 VS Code에서 열고 사용해야 합니다. CLAUDE.md가 이 폴더에 위치해 있어, 여기서 열어야 Claude가 Notion 규칙을 적용합니다.

📁 파일 구조

notion_summary_server/
├── CLAUDE.md           # Claude Code 작업 규칙 (Notion MCP + 주식 리서치)
├── server.py           # MCP 서버 메인 파일
├── .env                # 환경변수 (직접 생성, git 제외)
├── .env.example        # 환경변수 템플릿
├── .gitignore
├── requirements.txt
└── README.md

🗄️ Notion DB 구조

모두 "Finance & 투자" 페이지 (33117b872be68187a1b4ddc51261856e) 내 인라인 DB.

DB	ID	용도
📰 주식 리서치	`39bf50a1aca04ad2a10079e958cf96d4`	뉴스 / 산업분석 / 증권사리포트 / 주간브리핑
📚 주식 공부노트	`d1afcb876857487eb978c1a8e0952d05`	용어 / 이론 / 지표 / 전략 / 산업지식
📖 AI 논문	`34617b872be68060a474e18a73510f38`	논문 리뷰 및 요약

🔧 도구 (Tool)

도구	설명
`save_summary_to_notion`	논문·주식 리서치·공부노트를 Notion DB에 새 페이지로 저장
`update_notion_page`	기존 Notion 페이지에 내용 추가(append)

`save_summary_to_notion` 파라미터

파라미터	타입	필수	설명
`title`	string	✅	페이지 제목
`content`	string	✅	본문 내용
`source_url`	string	✅	원본 URL
`category`	`"paper"` \| `"stock_research"` \| `"stock_study"`	✅	저장 DB 선택
`sub_category`	string	❌	카테고리 세분류 (아래 참고)
`source`	string	❌	출처 (예: "한국경제", "삼성증권")
`tags`	list[string]	❌	태그 목록 (예: `["반도체", "AI", "국내"]`)
`difficulty`	string	❌	난이도 — `stock_study` 전용 (`"기초"` \| `"중급"` \| `"고급"`)

sub_category 옵션

category	sub_category 선택지
`stock_research`	`뉴스` \| `산업분석` \| `증권사리포트` \| `주간브리핑`
`stock_study`	`용어` \| `이론` \| `지표` \| `전략` \| `산업지식`
`paper`	해당 없음

`update_notion_page` 파라미터

파라미터	타입	필수	설명
`page_id`	string	✅	Notion 페이지 ID 또는 URL
`content`	string	✅	추가할 내용
`section_title`	string	❌	섹션 제목 (입력 시 `━━━ 제목 ━━━` 형식으로 구분선 표시)

⚙️ 설치

cd d:\python\notion_summary_server

# 가상환경 생성 (선택)
python -m venv .venv
.venv\Scripts\activate

# 의존성 설치
pip install -r requirements.txt

🔑 환경변수 설정

.env.example을 복사해 .env 파일 생성:

copy .env.example .env

.env 파일 내용:

NOTION_API_KEY=secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# AI 논문 DB
NOTION_PAPER_DB_ID=34617b872be68060a474e18a73510f38

# 주식 리서치 DB (뉴스 / 산업분석 / 증권사리포트 / 주간브리핑)
NOTION_STOCK_RESEARCH_DB_ID=39bf50a1aca04ad2a10079e958cf96d4

# 주식 공부노트 DB (용어 / 이론 / 지표 / 전략 / 산업지식)
NOTION_STOCK_STUDY_DB_ID=d1afcb876857487eb978c1a8e0952d05

🔌 Claude Code MCP 등록

터미널에서 실행:

claude mcp add notion_summary_server -- python d:/python/notion_summary_server/server.py

또는 ~/.claude/settings.json에 직접 추가:

{
  "mcpServers": {
    "notion_summary_server": {
      "command": "python",
      "args": ["d:/python/notion_summary_server/server.py"]
    }
  }
}

등록 후 Claude Code 재시작 → /mcp 명령으로 연결 확인.

💬 사용 예시

Claude에게 자연어로 요청하면 자동으로 MCP 도구를 선택해 실행합니다.

이 논문 정리해줘: https://arxiv.org/abs/2310.06825

→ category="paper" 로 AI 논문 DB에 저장

삼성전자 관련 한국경제 기사 저장해줘: https://www.hankyung.com/...

→ category="stock_research", sub_category="뉴스", tags=["반도체", "국내"]

PER 개념 정리해줘

→ category="stock_study", sub_category="지표", difficulty="기초"

주간 브리핑 해줘

→ WebSearch(거시경제/미국/국내/섹터) → 종합 분석 → sub_category="주간브리핑" 으로 저장

📋 주간 브리핑 수집 항목

항목	내용
🌐 글로벌 거시경제	연준 금리, 달러인덱스, WTI 유가, 금 가격
🇺🇸 미국 시장	S&P500 / 나스닥 등락, QQQ·SPY·SOXX ETF
🇰🇷 국내 시장	KOSPI / KOSDAQ, 외국인·기관 수급
📊 유망 섹터	모멘텀 상위 2~3개 섹터, 이유 설명
💡 ETF 추천	섹터별 대표 ETF + 투자 근거 + 리스크