ModMind MCP Server

This directory is the publishable MCP protocol layer extracted from ModMind. It implements a local stdio server using JSON-RPC MCP methods and forwards tool calls to an already-running ModMind bridge over loopback HTTP.

The initial snapshot tracks the ModMind desktop line at 1.3.4; the package version (0.1.0) is independent and should be bumped when the public bridge contract changes.

The server deliberately contains no Electron code, provider credentials, project data, logs, bundled Minecraft binaries, or third-party runtime dependencies. It is not a standalone Minecraft automation backend: a compatible bridge must implement the action contract in docs/bridge-contract.md.

로컬에서 실행

Node.js 18.18 이상이 필요합니다.

npm test
$env:MODMIND_BRIDGE_CONFIG = "C:\path\to\project\.modmind\external-agents\bridge.json"
node .\src\mcp-server.mjs

MCP 클라이언트는 프로세스를 시작하고 stdin/stdout에서 개행으로 구분된 JSON을 통해 통신합니다. stdout에 로그를 쓰지 마십시오. stdout은 프로토콜 채널입니다.

Related MCP server: mcp-stdio

클라이언트 구성

examples/mcp-config.json을 복사하고 두 경로를 교체한 다음, 로컬 stdio MCP 서버를 지원하는 클라이언트로 가져오십시오. 데스크톱 애플리케이션은 일반적으로 bridge.json과 프로젝트별 구성을 자동으로 생성합니다. MODMIND_BRIDGE_CONFIG는 bridge.json이 mcp-server.mjs 옆에 있을 때 선택 사항입니다.

ModMind 데스크톱 호스트 시작 명령, 프로젝트 선택, 수명 주기, 액션 매핑 및 호환성 요구 사항에 대해서는 docs/external-bridge-integration.zh-CN.md를 참조하십시오.

보안 모델

브리지는 127.0.0.1에 바인딩되며 x-modmind-token 헤더에 세션별 무작위 토큰이 필요합니다. bridge.json을 비밀로 취급하고, 세션이 종료되면 제거하며, 브리지 포트를 로컬 머신 외부로 노출하지 마십시오. MCP 서버는 쓰기/빌드 액션의 허용 여부를 결정하지 않습니다. 해당 정책은 호스트 애플리케이션과 그 검토 어댑터에 속합니다.

현재 상태

소스는 현재 ModMind 도구 이름과 액션 매핑을 반영합니다. 퍼블릭 액션 계약은 의도적으로 데스크톱 앱과 별도로 버전 관리됩니다. 릴리스를 게시하기 전에 docs/open-source-preparation.zh-CN.md의 준비 체크리스트를 실행하십시오.