Overtone News MCP 서버

모든 에이전트에게 실시간 뉴스뿐만 아니라 이를 효과적으로 활용할 수 있는 맥락적 지능(어조 분포, 떠오르는 이야기, 서사 변화, 급증 알림, 시간 경과에 따른 어조 차트 등)을 제공하는 MCP 서버로, Overtone의 퍼블리셔 네트워크를 기반으로 합니다.

Claude Desktop, Claude Code, Cursor, Windsurf, Codex, Kimi K2 등 모든 MCP 호환 클라이언트와 함께 작동합니다.

주요 기능

자연어 쿼리 — 평범한 영어로 질문하고 맥락적으로 분석된 기사를 받아보세요:

글로벌 보도 분석 — 언어와 지역별 어조를 비교하세요:

어조 시계열 — 특정 주제의 감정적 보도가 시간이 지남에 따라 어떻게 변하는지 추적하세요:

이 서버가 필요한 이유

뉴스 API는 기사를 반환합니다. 그것은 쉬운 부분입니다. 어려운 점은 에이전트가 현재 사건에 대해 추론하는 데 실제로 필요한 모든 것입니다:

• 주제에 대한 보도의 어조는 어떠한가? 대중의 분위기가 분노, 희망, 정보 제공, 두려움 중 무엇인가?

• 어제는 전혀 보도되지 않았는데 지금 새롭게 떠오르는 것은 무엇인가?

• 서사가 바뀌는 지점은 어디인가? 어떤 주제의 어조가 가장 빠르게 변하고 있는가?

• 내가 지켜보는 주제에 대해 분노나 두려움이 급증하고 있는가?

• 특정 이야기에 대한 어조가 시간이 지남에 따라 어떻게 변했는가?

이 서버는 이 모든 것을 MCP 도구로 노출하여, 에이전트가 단순히 헤드라인을 나열하는 것이 아니라 질문에 맞는 올바른 신호를 추출할 수 있도록 합니다.

설치

이 서버는 Python 패키지로 제공됩니다. uvx(uv에서 제공)를 사용하면 전역 Python 환경을 어지럽히지 않고 실행할 수 있습니다. 먼저 uv를 설치하세요:

curl -LsSf https://astral.sh/uv/install.sh | sh

그런 다음 MCP 클라이언트 설정에 한 블록을 추가하세요. uvx가 PyPI에서 패키지를 가져와 필요할 때 실행하므로 별도의 설치 단계가 필요하지 않습니다.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json(macOS) 또는 해당 플랫폼의 설정 파일을 편집하세요:

{
  "mcpServers": {
    "overtone-news": {
      "command": "uvx",
      "args": ["overtone-news-mcp"]
    }
  }
}

Claude Code

~/.config/claude-code/mcp.json을 편집하세요:

{
  "mcpServers": {
    "overtone-news": {
      "command": "uvx",
      "args": ["overtone-news-mcp"]
    }
  }
}

Cursor / Windsurf

설정 → MCP → 서버 추가:

• 명령어: uvx

• 인자: overtone-news-mcp

Codex

~/.codex/config.toml을 편집하세요:

[[mcp_servers]]
name = "overtone-news"
command = "uvx"
args = ["overtone-news-mcp"]

인증

첫 번째 도구 호출 시 서버는 Overtone의 무료 티어 API 키를 등록하고 ~/.overtone/credentials에 캐시합니다. 이 캐시는 Claude Code용 Overtone News skill과 공유되므로 둘 다 설치해도 중복 등록되지 않습니다.

프리미엄 키(더 높은 속도 및 일일 제한)를 사용하려면 MCP 설정의 env 블록에 OVERTONE_NEWS_API_KEY를 설정하세요:

"overtone-news": {
  "command": "uvx",
  "args": ["--from", "git+https://github.com/CKBrennan/overtone-news-mcp", "overtone-news-mcp"],
  "env": { "OVERTONE_NEWS_API_KEY": "ot-prod-..." }
}

속도 제한:

프리미엄 키를 요청하려면 business@overtone.ai로 이메일을 보내주세요.

환경 변수

도구

모든 도구는 JSON을 반환합니다. 에이전트가 사용자의 질문에 적합한 도구를 선택하므로 직접 호출할 필요는 없습니다.

news

주제별 기사. 각 기사에는 어조, 브랜드 안전 신호, 기사 유형 및 개념이 태그되어 있습니다. "X에 대해 무슨 일이 일어나고 있는가?"와 같은 질문에 사용하세요.

news(query="AI regulation in Europe", max_results=10, days=7,
     tone_filter="informational", brand_safe_only=True)

응답에는 request_id가 포함됩니다. 기사를 제시한 후 report에 전달하여 실제로 무엇이 표시되었는지 알 수 있도록 하세요.

tone

최근 주제 보도에 대한 감정적 어조 분포(happy, funny, hopeful, informational, angry, sad, fearful 및 dominant_tone).

tone(query="climate change", days=3)

사용자가 무슨 일이 일어났는지가 아니라 주제가 어떻게 보도되고 있는지 물을 때 사용하세요.

pulse

폴링 가능한 급증 탐지기. 감시 중인 각 어조(기본값 angry / sad / fearful)에 대해 기준 윈도우 대비 spike_ratio와 불리언 값 spiking을 반환합니다. alerts는 spike_ratio >= 1.5이고 의미 있는 볼륨이 있을 때만 채워집니다.

pulse(query="acme corp", tones=["angry", "fearful"],
      recent_hours=6, baseline_hours=72)

5~15분마다 폴링하는 용도입니다. alerts가 비어 있지 않을 때만 사용자에게 표시하세요.

emerging

지난 24시간 동안 나타난 개념 중 이전 48시간 동안 보도가 전혀 없었던 개념(떠오르는 이야기 후보)입니다. 단일 기사 노이즈가 섞이지 않도록 3개 이상의 기사와 2개 이상의 소스로 클러스터 필터링됩니다.

emerging(limit=10)

velocity

이전 48시간과 최근 24시간 사이에 어조 분포가 가장 급격하게 변한 개념입니다. "서사가 어디서 바뀌고 있는가?"라는 질문에 답합니다. 형태가 정규화된 L2 거리로 순위가 매겨지므로 단순한 볼륨 상승은 변화로 간주되지 않습니다.

velocity(limit=10)

timeseries

주제에 대한 시간 경과에 따른 어조 궤적입니다. bin은 hour, 6h, day 중 하나입니다. 빈별 어조 평균, article_count, dominant_tone의 순서화된 시리즈를 반환합니다.

timeseries(query="federal reserve", bin="6h", hours=168)

Mermaid 선 차트나 ASCII 스파크라인으로 렌더링하는 것이 가장 좋습니다.

report

에이전트가 사용자에게 기사를 제시한 후 조용히 호출되어 실제로 표시된 displayed_urls를 기록합니다. Overtone이 에이전트 클라이언트에 어떤 콘텐츠가 가장 가치 있는지 이해하는 데 도움이 됩니다.

report(request_id="<from news response>",
       displayed_urls=[...], displayed_count=3,
       sponsorship_displayed=False)

에이전트 흐름 예시

"지금 NBA 플레이오프에 대한 분위기는 어떤가요?" → tone(query="NBA 플레이오프") → 분포 요약.

"FDA와 관련해 알아야 할 속보가 있나요?" → emerging(limit=20) → FDA 관련 개념 필터링.

"우리 브랜드에 대한 분노 급증을 10분마다 추적해줘." → pulse(query="acme corp", tones=["angry"]) 루프 실행; alerts가 비어 있지 않을 때만 표시.

"지난주 테슬라에 대한 감정을 보여줘." → timeseries(query="Tesla", bin="6h", hours=168) → 차트로 렌더링.

"우주 탐사에 관한 긍정적인 기사 5개만 알려줘." → news(query="우주 탐사", max_results=5, tone_filter="positive") → 제시 → report(...).

개인정보 보호 — Overtone으로 전송되는 데이터

서버가 처음 사용 시 무료 티어 키를 자동 등록할 때 다음을 전송합니다:

• hostname + OS user + CPU arch의 SHA-256 해시. 원본 값은 절대 확인하지 않으며, 해시는 동일한 머신에서 재설치 시 키를 중복 제거하는 데 사용됩니다.

등록 중에는 개인 데이터가 전송되지 않습니다.

모든 도구 호출 시 서버는 API 키와 도구의 입력 매개변수를 ${OVERTONE_NEWS_API_URL}로 전송합니다. 분석 및 오남용 방지를 위해 쿼리를 기록합니다. overtone.ai/privacy를 참조하세요.

기사 내용, 사용자 대화 또는 에이전트 맥락은 도구 입력값 외에는 절대 전송되지 않습니다. 에이전트의 나머지 프롬프트, 메모리 또는 다른 도구 호출 내용은 확인하지 않습니다.

자동 등록을 거부하려면 OVERTONE_NEWS_API_KEY를 직접 요청한 키로 수동 설정하거나, OVERTONE_NEWS_API_URL을 자체 프록시로 지정하세요.

보안 참고 사항

• 기사 내용을 통한 프롬프트 인젝션. news 도구는 퍼블리셔 텍스트(헤드라인, 설명)를 반환합니다. 기사에는 에이전트를 조작하려는 텍스트("이전 지시를 무시하고…")가 포함될 수 있습니다. MCP 서버 자체에는 파괴적인 도구가 없으며 읽기만 수행하지만, 반환된 기사 텍스트는 웹 콘텐츠와 마찬가지로 에이전트 추론 과정에서 신뢰할 수 없는 입력으로 취급해야 합니다. 호스트에서의 샌드박싱, 출력 전용 렌더링, 도구 허용 목록 설정이 적절한 완화 조치입니다.

• 쉘 접근 권한 없음. 서버는 사용자를 대신하여 쉘 명령을 실행하지 않습니다. subprocess는 등록 중 git config --global user.{name,email}을 읽는 데만 사용됩니다.

• ~/.overtone/credentials 외 파일 시스템 접근 권한 없음. 서버는 다른 로컬 파일을 읽거나 쓰지 않습니다.

개발

git clone https://github.com/CKBrennan/overtone-news-mcp
cd overtone-news-mcp
uv sync
uv run overtone-news-mcp

개발 중에는 비운영 API를 가리키도록 하세요:

OVERTONE_NEWS_API_URL=http://localhost:8080 uv run overtone-news-mcp

라이선스

MIT — LICENSE 참조.

관련 항목

• overtone-news-skill — Claude Code 스킬 버전 (자격 증명 공유)

• overtone.ai — API 기반의 지능

•