코다 MCP 서버

이 프로젝트는 Coda API와 상호 작용하는 다리 역할을 하는 모델 컨텍스트 프로토콜(MCP) 서버를 구현합니다. MCP 클라이언트(AI 어시스턴트 등)가 특정 Coda 문서에 대해 페이지 나열, 생성, 읽기, 업데이트, 복제 등의 작업을 수행할 수 있도록 합니다.

특징

서버는 MCP 클라이언트에 다음 도구를 제공합니다.

• list-pages : 구성된 Coda 문서 내의 모든 페이지를 나열합니다.
• create-page : 문서에 새 페이지를 만들고, 선택적으로 초기 마크다운 콘텐츠로 채웁니다.
• get-page-content : 지정된 페이지의 콘텐츠(ID 또는 이름)를 마크다운으로 검색합니다.
• update-page : 지정된 페이지에 마크다운 콘텐츠를 바꾸거나 추가합니다.
• duplicate-page : 기존 페이지의 복사본을 새 이름으로 만듭니다.

용법

다음 실행 명령을 사용하여 Cursor/Claude Desktop/기타에 MCP 서버를 추가합니다.

지엑스피1

예를 들어, Cursor/Claude Desktop에서는 다음과 같이 추가할 수 있습니다.

필수 환경 변수:

• API_KEY : Coda API 키입니다. Coda 계정 설정에서 생성할 수 있습니다.
• DOC_ID : 서버와 상호 작용할 Coda 문서의 ID입니다. 문서 URL( d 뒤 부분)에서 확인할 수 있습니다.

로컬 설정

1. 필수 조건:
   • 노드.js
   • pnpm
2. 저장소를 복제합니다.
   git clone <repository-url> cd coda-mcp
3. 종속성 설치:
   pnpm install
4. 프로젝트를 빌드하세요:
   pnpm build
   이렇게 하면 TypeScript 코드가 dist/ 디렉토리의 JavaScript로 컴파일됩니다.

서버 실행

MCP 서버는 표준 입출력(stdio)을 통해 통신합니다. 실행하려면 환경 변수를 설정하고 컴파일된 JavaScript 파일( dist/index.js 을 실행하세요.

개발

• 린팅: pnpm lint
• 포맷: pnpm format
• OpenAPI 클라이언트 생성: pnpm openapi-ts (Coda API 사양이 변경되는 경우)