Skip to main content
Glama
wishlist-mcp

wishlist-mcp

by teslakoile

wishlist-mcp

wishlist.fit을 위한 호스팅 MCP 서버입니다. Claude, ChatGPT 또는 Codex가 사용자를 대신하여 위시리스트를 읽고 업데이트할 수 있게 해줍니다.

https://mcp.wishlist.fit/mcp

app.wishlist.fit/connect에서 연결할 수 있으며, 클라이언트별 설정 단계가 있습니다. 먼저 wishlist 계정이 필요합니다. 이 서버는 계정을 생성하지 않습니다.

docs/connecting.md에는 더 자세한 내용이 있습니다: 각 클라이언트에 대한 정확한 명령, 프로덕션에서 실제로 검증된 사항, 그리고 잘못 설정하면 오후를 낭비하게 되는 두 가지 Codex 플래그에 대한 설명입니다.

개요

wishlist REST API 앞에 있는 순수 OAuth 2.1 리소스 서버입니다. 데이터베이스나 비즈니스 규칙을 보유하지 않습니다. 가시성, 속도 제한, 초대 처리는 모두 wishlist API에 있으며, 이 서버는 사용자 자신의 액세스 토큰으로 해당 API를 호출하여 이를 상속받습니다.

이러한 분리는 의도적입니다. 대안인 자체 규칙 사본을 가진 두 번째 서비스는 두 표면이 누가 무엇을 볼 수 있는지에 대해 조용히 불일치하기 시작하는 방식입니다.

Claude / ChatGPT / Codex
        │  MCP over HTTP, bearer token
        ▼
   this server ──── verifies the token (issuer + audience)
        │
        │  the same token, forwarded
        ▼
   api.wishlist.fit ──── applies visibility, rate limits, invite rules
        │
        ▼
     Postgres

WorkOS AuthKit이 인증 서버입니다. 이 서버는 아무것도 발급하지 않으며 동의 화면을 표시하지 않습니다. AuthKit이 서명한 내용만 검증합니다.

Related MCP server: Personal Toolkit MCP Server

도구

웹 앱에서 수동으로 할 수 있는 각 작업당 하나씩, 총 14개입니다. 패리티가 원칙입니다: 에이전트 전용 권한이 없으며, 앱 자체가 할 수 없는 일은 없습니다.

도구

종류

wishlist_search_people

읽기

wishlist_get_gift_guide

읽기

wishlist_get_profile

읽기

wishlist_get_wishlist

읽기

wishlist_get_my_profile

읽기

wishlist_get_my_wishlist

읽기

wishlist_list_circle

읽기

wishlist_preview_invite

읽기

wishlist_add_item

쓰기

wishlist_update_item

쓰기

wishlist_update_my_profile

쓰기

wishlist_accept_invite

쓰기

wishlist_create_invite

파괴적

wishlist_delete_item

파괴적

wishlist_get_gift_guide는 사람의 프로필과 위시리스트를 함께 반환합니다. 누구나 이 서버를 연결하는 이유이며, 이것이 없으면 선물을 주는 여정은 세 번의 왕복이 필요합니다.

두 파괴적 도구는 destructiveHint: true를 가지므로, 되돌릴 수 없는 작업을 확인하는 클라이언트는 먼저 물어볼 것입니다. 초대를 보내면 실제 사람에게 이메일이 가며 되돌릴 수 없습니다. 초대를 수락하는 것은 상호적입니다: 초대자가 당신의 서클 전용 필드에 접근할 수 있게 되고, 당신도 그들의 필드에 접근할 수 있게 됩니다.

하나의 연결, 모든 것

스코프가 없습니다. WorkOS는 사용자 정의 스코프를 표현할 수 없으므로, 연결은 전체 도구 표면을 전달합니다. 쓰기 보호는 구조적이기보다 행동적입니다: 위의 주석, 도구 설명, 그리고 API가 적용하는 속도 제한입니다.

로컬에서 실행하기

uv sync
cp .env.example .env      # point it at a local API and the Local WorkOS environment
uv run python -m wishlist_mcp.main
uv run pytest
uv run ruff format --check . && uv run ruff check .

테스트는 respx로 wishlist API를 스텁합니다. 테스트가 확인하는 것은 이 서버의 고유 작업입니다: 토큰 검증, 요청 구성, API 오류를 모델이 행동할 수 있는 문장으로 변환하는 것입니다. 규칙 자체는 API에 속하며 거기서 테스트됩니다.

구성

모든 변수는 WISHLIST_MCP_ 접두사가 붙습니다. .env.example을 참조하세요.

변수

용도

API_BASE_URL

호출할 wishlist REST API

AUTHKIT_DOMAIN

WorkOS AuthKit 발급자. 비어 있으면 서버가 시작을 거부합니다

RESOURCE_URI

정식 URI. 모든 토큰의 대상(audience)이 정확히 일치해야 합니다

HOST

서버는 다른 호스트에 대해 404를 반환합니다

API_TIMEOUT

API에 대해 기다리는 시간(초)

RESOURCE_URI는 WorkOS에 구성된 리소스 표시기와 문자 그대로 일치해야 하며, /mcp 경로도 포함합니다. 불일치는 클라이언트가 연결을 거부하는 가장 흔한 이유입니다.

변경하기 전에 알아야 할 사항

이 각각은 한 번 프로덕션에 도달한 버그입니다.

  • get_http_headers()는 authorization을 제거합니다. 명시적으로 요청하세요. 그렇게 하지 않으면 모든 도구 호출이 "액세스 토큰 없음"을 보고하는 반면 initialize와 tools/list는 여전히 성공합니다. 왜냐하면 그것들은 도구 본문이 실행되기 전에 응답되기 때문입니다. 녹색 핸드셰이크는 도구가 작동한다는 증거가 아닙니다.

  • MCP 앱은 루트에 마운트되며 자체 경로를 소유합니다. /mcp에 마운트하면 Starlette가 /mcp를 /mcp/로 리디렉션하고, 모든 클라이언트에 전달되는 주소에는 후행 슬래시가 없습니다.

  • X-Forwarded-Proto는 신뢰됩니다. Cloud Run이 TLS를 종료하므로, 이것이 없으면 생성된 모든 URL이 http://를 주장합니다. 위의 리디렉션과 결합하면, 한때 클라이언트가 베어러 토큰을 평문으로 보냈을 수 있음을 의미했습니다.

  • FastMCP의 수명 주기는 앱의 수명 주기에 연결됩니다. ASGI 앱을 마운트해도 수명 주기가 시작되지 않으며, 이것이 없으면 모든 도구 호출이 "Task group is not initialized"로 실패하는 반면 단위 테스트는 여전히 통과합니다.

  • TestClient는 기본적으로 리디렉션을 따릅니다. 경로가 직접 응답한다는 것이 요점일 때 follow_redirects=False를 전달하세요.

  • FastMCP는 Accept를 부분 문자열로 일치시킵니다. */*를 보내는 클라이언트(이미 그렇게 함)와 헤더를 전혀 보내지 않는 클라이언트(RFC 9110에 따라 그렇게 함)에게 406 Client must accept application/json으로 응답합니다. WildcardAccept는 FastMCP가 보기 전에 이를 명시합니다. 일반 curl은 */*를 보내므로, 이것이 누구나 처음 부딪히는 문제였습니다.

배포

Cloud Run, asia-southeast1, wishlist의 나머지와 같은 프로젝트에 있습니다. main은 푸시 시 배포됩니다. 인프라는 wishlist-infrastructure에 있습니다.

라이선스

MIT. LICENSE를 참조하세요.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      MCP server for the forme.gifts wishlist app that enables managing wishlists and gifts from Claude Code, Claude Desktop, Cursor, and other MCP clients.
      10
      15 npm
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      A custom MCP server that turns Claude into an agentic shopping assistant for searching products, comparing options, managing a cart, and checking out with built-in guardrails for safe autonomous commerce.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      A production-ready MCP server that gives an LLM agent standalone-equivalent control over a Mineflayer Minecraft bot — movement, mining, crafting, inventory, combat, containers, chat, and much more — exposed as 110 strongly-typed tools across 23 groups, with full bot lifecycle management and dual (poll + push) event streaming.
      159 npm
      10
      MIT