Home MCP starter

홈 머신이나 NAS에서 실행하고 Kody에 연결하는 작은 Streamable HTTP MCP 서버입니다. 도구는 이 프로세스에서 실행됩니다. Kody는 CIMD OAuth 후 HTTPS를 통해 도구에 도달합니다. 공식 Kody 가이드는 홈 MCP 서버 연결입니다.

가계 메모가 교체 가능한 기본 표면으로 제공됩니다. 리포지토리를 포크하고, 실제로 원하는 LAN API와 로컬 CLI로 해당 도구를 교체한 다음, Cloudflare Tunnel 및 Access로 호스트를 게시하세요.

사용 사례

• 같은 머신에 개인 메모 파일(또는 Obsidian 볼트 사이드카)을 유지

• LAN에서만 응답하는 홈 기기 제어

• 노트북이 이미 신뢰하는 로컬 CLI 래핑

• NAS 공유 옆에 자동화 호스팅

Kody는 클라우드에서 실행됩니다. Kody는 네트워크의 localhost를 열 수 없습니다. 이 서버는 그 일을 할 수 있는 프로세스이며, 공개 MCP URL이 Kody가 연결하는 방법입니다. 사용 사례를 참조하세요.

Related MCP server: mcp-devtools

빠른 시작

로컬 개발

Node 24가 필요합니다.

cp .env.example .env
npm install
npm run dev

상태 페이지는 http://127.0.0.1:4040/입니다. 상태 확인은 /health입니다. MCP는 /mcp입니다.

Docker

cp .env.example .env
# Set HOME_MCP_PUBLIC_BASE_URL to the HTTPS hostname you will publish.
docker compose up --build -d

볼륨, NAS 스타일 Container Manager 참고 사항, 이미지 업데이트는 Docker를 참조하세요.

문서

• 시작하기

• 사용 사례

• Docker

• Cloudflare Tunnel

• Cloudflare Access

• OAuth 및 CIMD

• 도구 추가

• Kody 연결

Kody에 연결

1. 이 프로세스를 HTTPS 호스트 이름에 게시합니다(Tunnel + Access).

2. /account/mcp-servers를 엽니다.

3. 공개 /mcp URL을 사용하여 서버를 home으로 추가합니다.

4. 인증 URL을 열고, 메시지가 표시되면 Access를 통과한 후 승인합니다.

5. mcp:home에서 기능을 검색합니다.

자세한 내용은 Kody 연결에 있습니다.

보안

• MCP 클라이언트는 CIMD 전용 OAuth 및 PKCE S256으로 인증합니다. Dynamic Client Registration 엔드포인트는 없습니다.

• RFC 8707 resource 매개변수는 이 서버의 MCP URL과 같아야 합니다.

• Cloudflare Access는 사람용 경로(/authorize, /)를 보호합니다. 머신 경로(/mcp, /token, /revoke, /.well-known, /health)는 Kody가 OAuth를 완료하고 도구를 호출할 수 있도록 계속 접근 가능합니다. Access는 MCP OAuth를 대체하지 않습니다.

• LAN 출처는 신뢰됩니다. 제한 없는 셸을 노출하지 마세요. 도구는 좁은 범위로 유지하세요.

• Kody 계정당 OAuth 권한을 하나만 발급하세요. 계정 간에 bearer 토큰을 공유하지 마세요.

커뮤니티

Kody는 Kent C. Dodds의 캐릭터입니다. 이 프로젝트는 kody-bot의 공식 home MCP starter입니다.