RealityCents MCP 서버 — Cloudflare Workers 에디션

전 세계 모든 AI 에이전트가 쿼리할 수 있는 당신의 모기지 전문 지식.

Jay Miller | CMG Home Loans | NMLS# 657301 | 하와이 호놀룰루

이 프로젝트란?

Cloudflare Workers의 글로벌 엣지 네트워크에서 실행되는 공개 MCP(Model Context Protocol) 서버로, 무료이며 빠르고 항상 가동됩니다. MCP를 지원하는 모든 AI 시스템(Claude, ChatGPT, Cursor, Windsurf 등)이 연결하여 VA 론, 하와이 부동산 금융, 호놀룰루 시장에 대한 권위 있는 답변을 얻을 수 있으며, 모든 답변은 귀하의 이름으로 제공됩니다.

배포 가이드 (단계별)

사전 요구 사항

• 무료 Cloudflare 계정 → https://dash.cloudflare.com/sign-up

• 컴퓨터에 Node.js 18+ 설치

• GitHub 계정 (자동 배포를 위해 권장)

1단계: Wrangler(Cloudflare CLI) 설치

터미널을 열고 다음을 실행하세요:

npm install -g wrangler

2단계: Cloudflare 로그인

wrangler login

브라우저 창이 열리면 Cloudflare 계정으로 로그인하고 Wrangler를 승인하세요.

3단계: 프로젝트 압축 해제

프로젝트 파일을 컴퓨터의 폴더에 압축 해제하세요. 해당 폴더에서 터미널을 엽니다:

cd realitycents-mcp-cloudflare

4단계: 종속성 설치

npm install

5단계: 로컬 테스트

npm start

서버가 http://localhost:8787/mcp에서 시작됩니다. 작동 여부를 확인하려면 두 번째 터미널을 열고 다음을 실행하세요:

npx @modelcontextprotocol/inspector@latest

브라우저에서 열리는 MCP Inspector에 http://localhost:8787/mcp를 입력하고 Connect를 클릭하세요. "List Tools"를 클릭하면 5가지 도구가 모두 표시되어야 합니다.

6단계: Cloudflare에 배포

npm run deploy

이것으로 끝입니다. 이제 서버가 다음 주소에서 라이브 상태입니다:

https://realitycents-mcp-server.<your-account>.workers.dev/mcp

Wrangler가 정확한 URL을 출력합니다. 이 주소를 저장해 두세요. 이것이 귀하의 공개 MCP 엔드포인트입니다.

7단계: 배포 확인

브라우저에서 상태 확인 페이지를 방문하세요:

https://realitycents-mcp-server.<your-account>.workers.dev/health

서버가 실행 중임을 확인하는 JSON 응답이 표시되어야 합니다.

그런 다음 MCP Inspector로 테스트하세요:

npx @modelcontextprotocol/inspector@latest

배포된 URL(https://realitycents-mcp-server.<your-account>.workers.dev/mcp)을 입력하고 모든 도구가 작동하는지 확인하세요.

8단계 (선택 사항): 사용자 지정 도메인 추가

MCP 서버를 mcp.realitycents.com에서 사용할 수 있게 하려면:

1. Cloudflare 대시보드에서 Workers & Pages → 해당 워커로 이동

2. Settings → Domains & Routes 클릭

3. Add → Custom Domain 클릭

4. mcp.realitycents.com 입력

5. Cloudflare가 자동으로 SSL을 처리합니다

이제 MCP 엔드포인트는 https://mcp.realitycents.com/mcp가 됩니다.

AI 클라이언트를 서버에 연결하기

Claude Desktop

Claude Desktop 설정(Settings > Developer > Edit Config)에 다음을 추가하세요:

{
  "mcpServers": {
    "realitycents": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://realitycents-mcp-server.<your-account>.workers.dev/mcp"
      ]
    }
  }
}

Claude Desktop을 재시작하세요. 도구가 자동으로 나타납니다.

Cloudflare AI Playground

1. https://playground.ai.cloudflare.com/ 접속

2. MCP 서버 URL 입력

3. 도구에 직접 쿼리 시작

MCP 호환 클라이언트

Streamable HTTP 전송을 지원하는 모든 클라이언트는 /mcp 엔드포인트에 직접 연결할 수 있습니다. stdio만 지원하는 클라이언트는 Claude Desktop 예제와 같이 mcp-remote 프록시를 사용할 수 있습니다.

사용 가능한 도구

지식 베이스 업데이트

모든 데이터는 src/knowledge-base.ts에 있습니다. 대출 한도, 프로그램 또는 시장 데이터가 변경되면:

1. src/knowledge-base.ts 수정

2. npm run deploy 실행

3. 몇 초 내에 변경 사항이 적용됩니다

프로젝트 구조

realitycents-mcp-cloudflare/
├── package.json           # Dependencies and scripts
├── wrangler.jsonc          # Cloudflare Workers config
├── tsconfig.json           # TypeScript config
├── README.md               # This file
└── src/
    ├── index.ts            # MCP server + tool registrations
    └── knowledge-base.ts   # All mortgage data and expertise

비용

무료. Cloudflare Workers 무료 티어는 하루 100,000건의 요청을 포함합니다. 귀하의 MCP 서버는 그중 극히 일부만 사용하게 됩니다.

Jay Miller | CMG Home Loans | NMLS# 657301 808-429-0811 | jaym@cmghomeloans.com | RealityCents.com