agent-mcp-sync

하나의 mcp.json 설정 파일로 Claude Code와 opencode의 MCP 서버 설정을 동기화합니다.

설치

npm install agent-mcp-sync

사용법

설정 파일 작성

mcp.json 파일을 만듭니다:

{
  "$schema": "node_modules/agent-mcp-sync/schema.json",
  "my-remote-server": {
    "type": "remote",
    "url": "https://mcp.example.com/sse",
    "headers": {
      "Authorization": "Bearer ${API_TOKEN}"
    }
  },
  "my-local-server": {
    "type": "stdio",
    "command": ["npx", "-y", "some-mcp-server"]
  }
}

서버 종류

| 종류 | 필수 항목 | 설명 | |------|----------|------| | remote | url | HTTP로 연결하는 원격 서버. headers에 ${ENV_NAME} 형식으로 환경변수 치환 가능 | | stdio | command | 표준 입출력으로 연결하는 로컬 서버 |

CLI 실행

# 기본 (현재 디렉토리의 mcp.json 사용)
agent-mcp-sync

# 설정 파일 지정
agent-mcp-sync --config=path/to/mcp.json

# 프로젝트 단위 설정도 함께 생성
agent-mcp-sync --project=./my-project

프로그래밍 방식

import { readServers, syncMcp } from "agent-mcp-sync";

const servers = readServers("mcp.json");
syncMcp(servers, { project: "./my-project" });

동기화 대상

| 대상 | 경로 | 비고 | |------|------|------| | Claude Code (전역) | ~/.claude.json | 파일이 없으면 건너뜀 | | opencode (전역) | ~/.config/opencode/opencode.json | 파일이 없으면 건너뜀 | | Claude Code (프로젝트) | <project>/.mcp.json | --project 지정 시 생성 | | opencode (프로젝트) | <project>/opencode.json | --project 지정 시 생성 |

라이선스

MIT