InstantDB MCP Server

@instantdb/mcp

시작하기 · 예제 · 문서 · Discord

Instant의 MCP 서버에 오신 것을 환영합니다.

Instant MCP

이 MCP는 Instant Platform SDK를 감싸는 래퍼입니다. 이 MCP를 편집기에 추가하면 InstantDB 애플리케이션을 생성, 관리 및 업데이트할 수 있습니다.

원격 MCP 서버

Instant는 https://mcp.instantdb.com에서 최신 버전의 서버를 호스팅합니다.

스트리밍 HTTP를 지원하는 최신 클라이언트의 경우 https://mcp.instantdb.com/mcp를 사용하세요.

SSE가 필요한 레거시 클라이언트의 경우 https://mcp.instantdb.com/sse을 사용하세요.

편집기별 자세한 지침은 공개 문서를 참조하세요.

로컬 MCP 서버

아직 준비되지 않았다면 Instant 대시보드에서 개인 액세스 토큰을 발급받으세요.

npx -y @instantdb/mcp --token <token>로 stdio 모드에서 서버를 실행하세요.

편집기별 자세한 지침은 공개 문서를 참조하세요.

기여하기

빠른 시작

이 저장소를 클론하고 MCP Inspector @modelcontextprotocol/inspector를 사용하여 로컬에서 이 서버를 디버깅하고 개발하세요.

# Clone this repo
git clone ..

# Navigate to the cloned directory and build the MCP server
cd ..
npm run build

# Run the server
npx @modelcontextprotocol/inspector node ./dist/index.js --token <token>

# Or alternatively via environment variable
INSTANT_ACCESS_TOKEN=<token> npx @modelcontextprotocol/inspector node ./build/index.js

# You can also specify a url to connect to a local instance of your instant server
npx @modelcontextprotocol/inspector node ./dist/index.js --token <token> --api-url
http://localhost:8888

Claude Code를 사용 중이라면 빌드 후 바로 MCP 서버를 추가할 수 있습니다:

claude mcp add --transport stdio instant-local -- node <path-to-your-cloned-repo>/dist/index.js --token <token>

그런 다음 서버를 바로 제거할 수 있습니다:

claude mcp remove instant-local

또한 편집기가 로컬 MCP에 연결되도록 구성할 수 있습니다. 다음은 MacOS/Linux용 구성 예제입니다:

{
  "mcpServers": {
    "instant": {
      "command": "node",
      "args": [
        "<path-to-your-cloned-repo>/dist/index.js",
        "--token",
        "<token>",
        "--api-url",
        "http://localhost:8888"
      ]
    }
  }
}

원격 MCP

cp .env.example .env

새 .env 파일에 모든 환경 변수를 입력하세요.

pnpm run dev

http://localhost:3123에서 서버에 접속하세요.

코드베이스의 stdio 버전에서 작업하려면 .env 파일을 SERVER_TYPE=stdio로 업데이트하세요.