EMMA MCP — Blaylock Van을 위한 맞춤형 지방채 금융 에이전트

NYU Stern 컨설팅 캡스톤 · 2026년 봄 · Marco Figueroa, Justin Ganjian, Andrew Kay, Isaac Mizrahi, Roshan Raja · Marciano 교수

소개

Claude가 MSRB의 EMMA 웹사이트에서 직접 지방채 신규 발행 시장 정보를 읽을 수 있게 해주는 맞춤형 MCP(Model Context Protocol) 서버입니다. 이는 캡스톤 계층 사다리의 Tier-4 예시로, 어떤 벤더도 다루지 않는 데이터 소스에 대한 기업 소유 커넥터입니다.

EMMA(Municipal Securities Rulemaking Board에서 운영하는 Electronic Municipal Market Access 사이트)는 미국에서 판매되는 모든 지방채에 대한 공식 공공 기록부입니다. 신규 발행 일정, 공식 성명서(Official Statements), CUSIP 수준의 세부 정보, 최근 거래 가격 등이 모두 EMMA에 있습니다. 이 사이트는 공개 API를 제공하지 않습니다.

이 MCP는 Claude가 연결 시 자동으로 로드하는 18개의 도구와 2개의 리소스(CLAUDE.md 규칙 파일 및 EMMA_ABBREVIATIONS.md 용어집)를 노출합니다. 설치가 완료되면, 은행원은 Claude에게 *"Rady Children's Hospital의 모든 미상환 채권을 가져와서 가장 최근의 OS를 다운로드해줘"*와 같은 자연어 질문을 할 수 있으며, Claude는 검색 → 발행자 조회 → 발행 세부 정보 → PDF 다운로드 → 텍스트 추출로 이어지는 전체 체인을 약 20초 만에 실행합니다.

전체적인 설명과 Blaylock에게 중요한 이유는 USAGE.md → Why this exists를 참조하십시오.

Related MCP server: nyc-property-intel

사전 요구 사항

노트북에 다음 네 가지가 필요합니다. 누락된 항목이 있으면 아래 설치 지침에서 다룹니다.

설치 — Mac

# 1. Unzip this folder somewhere sensible
cd ~/Downloads
unzip emma-mcp.zip -d ~/emma-mcp
cd ~/emma-mcp

# 2. If you don't have uv:
brew install uv

# 3. Create the venv + install dependencies (one command)
uv sync

# 4. Install the headless browser Playwright drives
uv run playwright install chromium

# 5. Smoke-test the server (optional — confirms it boots)
uv run python server.py
# You should see the server start and wait on stdin.
# Press Ctrl+C to stop.

Claude Desktop에 연결 (Mac)

1. Claude Desktop → Settings → Developer → Edit Config를 엽니다. 그러면 claude_desktop_config.json이 열립니다.

2. mcpServers 객체 내부에 emma 항목을 추가합니다. uv sync가 방금 생성한 .venv/bin/python에 대한 절대 경로와 server.py에 대한 절대 경로를 사용하십시오:

{
  "mcpServers": {
    "emma": {
      "command": "/Users/YOURNAME/emma-mcp/.venv/bin/python",
      "args": ["/Users/YOURNAME/emma-mcp/server.py"]
    }
  }
}

3. 저장 후 Claude Desktop을 완전히 종료(Cmd+Q, 창만 닫지 마십시오)하고 다시 엽니다.

4. 새 채팅에서 작성 창의 망치 아이콘을 클릭했을 때 EMMA 도구가 나열되어야 합니다. 이것이 연결 확인 방법입니다.

설치 — Windows

# 1. Unzip this folder, e.g. to C:\emma-mcp
cd C:\emma-mcp

# 2. If you don't have Python: install from python.org (3.10 or later).
#    Check "Add Python to PATH" during install.

# 3. Install uv
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# 4. Create the venv + install deps
uv sync

# 5. Install Playwright's Chromium
uv run playwright install chromium

# 6. Smoke-test
uv run python server.py
# Ctrl+C to stop.

Claude Desktop에 연결 (Windows)

1. 텍스트 편집기에서 %APPDATA%\Claude\claude_desktop_config.json을 엽니다. (해당 경로를 탐색기 주소 표시줄에 붙여넣으면 Windows가 %APPDATA%를 C:\Users\사용자명\AppData\Roaming으로 확인합니다.)

2. JSON 경로에는 슬래시(/) 또는 이중 백슬래시(\)를 사용하십시오. Windows의 단일 백슬래시는 JSON을 깨뜨립니다:

{
  "mcpServers": {
    "emma": {
      "command": "C:/emma-mcp/.venv/Scripts/python.exe",
      "args": ["C:/emma-mcp/server.py"]
    }
  }
}

3. 저장 후 Claude Desktop을 완전히 종료(트레이 아이콘 우클릭 → Quit)하고 다시 엽니다.

4. 작성 창의 망치 아이콘에서 EMMA 도구를 확인하십시오.

첫 번째 프롬프트 — 60초 검증

새 Claude Desktop 채팅을 열고 다음을 붙여넣으십시오:

Use the EMMA MCP to pull the upcoming new-issue calendar for the next week. Filter to NY state only. Return a clean table with issuer, par, dated, and sector.

Claude가 state="NY"와 함께 get_new_issue_calendar를 호출하고, 몇 초 내에 약 10-25개의 행을 가져와 EMMA URL이 포함된 표 형식으로 정리하는 것을 볼 수 있습니다. 이것이 작동하면 다른 모든 도구도 동일하게 작동합니다.

더 인상적인 데모를 보려면 다음을 시도하십시오:

Find Rady Children's Hospital on EMMA, pull their outstanding bonds, get the most recent issue's details, download the Official Statement, and summarize the rating language and use of proceeds from the first 10 pages.

이 작업은 전체 5단계 도구 체인을 약 20초 만에 끝까지 실행합니다.

더 많은 데모 프롬프트는 USAGE.md에 있습니다.

문제 해결

재시작 후 Claude Desktop에 EMMA 도구가 표시되지 않음.

• JSON이 유효한지 확인하십시오 (python3 -m json.tool < claude_desktop_config.json — 출력 없음 = 정상).

• 구성의 두 경로가 모두 절대 경로이며 존재하는지 확인하십시오. 상대 경로와 ~는 작동하지 않습니다.

• Claude Desktop을 완전히 종료하십시오 (Cmd+Q / 트레이 Quit — 창을 닫는 것만으로는 계속 실행됩니다).

• ~/Library/Logs/Claude/mcp*.log(Mac) 또는 %APPDATA%\Claude\logs\mcp*.log(Windows)에서 Claude Desktop의 MCP 로그를 확인하여 특정 오류를 찾으십시오.

playwright install chromium이 멈추거나 실패함.

• 최초 설치 시 약 150MB를 다운로드하며 가정용 인터넷 연결에서 1-2분 정도 소요됩니다. 기다려 주십시오.

• 기업 프록시 환경인 경우 실행 전에 HTTPS_PROXY 및 HTTP_PROXY를 설정하십시오.

Claude가 도구를 호출했는데 "EMMA disclaimer loop"가 반환되거나 시간 초과됨.

• EMMA는 첫 방문 시 CUSIP 면책 조항 쿠키를 설정합니다. 서버가 이를 미리 시드(Disclaimer6=msrborg)하지만, 드물게 EMMA가 쿠키 이름을 변경할 수 있습니다. Claude Desktop을 재시작하여 브라우저 컨텍스트를 재설정하십시오. 문제가 지속되면 EMMA가 다운되었을 수 있습니다. 일반 브라우저에서 https://emma.msrb.org를 확인하십시오.

반환된 표에 9자리 CUSIP 대신 cusip_hash: ABC123…가 표시됨.

• 이는 버그가 아니라 의도된 것입니다. EMMA는 CUSIP을 이미지 태그로 렌더링하므로(CGS 라이선스 규칙), 서버가 HTML에서 이를 읽을 수 없습니다. 공식 성명서(Official Statement) PDF가 공식 CUSIP 소스입니다. download_official_statement를 사용한 다음 extract_pdf_text를 사용하십시오. 표지와 안쪽 표지에 실제 CUSIP이 포함되어 있습니다.

"Rady Children's" 검색 시 Franklin OH 및 Pittsburgh PA 어린이 병원은 찾지만 Rady는 찾지 못함.

• 이는 서버 버그가 아니라 EMMA의 알려진 특성입니다. Rady의 채권은 캘리포니아 도관(CHFFA / CPFA) 하에 파일링되며, EMMA의 QuickSearch는 인덱싱하지만 약하게 인덱싱하는 피연산자 괄호 부분에만 "RADY CHILDRENS"가 포함되어 있습니다. emma_quick_search {query: "rady"}를 시도하거나 도관을 직접 검색하십시오: search_issuers_by_state {state: "CA", contains: "health care facilities"}. 전체 피연산자 조회 플레이북은 USAGE.md → The conduit cheat sheet를 참조하십시오.

서버는 시작되는데 Claude가 "no tools available"이라고 함.

• server.py를 수정하여 Python 구문 오류가 발생했을 가능성이 큽니다. 터미널에서 uv run python server.py를 실행하십시오. 오류가 있으면 stderr로 출력됩니다. 수정 후 Claude Desktop을 재시작하십시오.

폴더 구성

한 줄 요약

우리는 어떤 벤더도 제공하지 않는 EMMA MCP를 구축하고, 모든 마켓플레이스 커넥터와 동일한 프로토콜을 통해 Claude에 연결했으며, 은행원이 읽고 편집할 수 있는 일반 마크다운 규칙 파일로 관리했습니다. 이것이 기업이 자신의 도구를 직접 소유할 때의 Tier 4 모습입니다.