Coda MCP Server

코다 MCP 서버

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

특징

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

• coda_list_documents : 사용자가 사용할 수 있는 모든 문서를 나열합니다.
• coda_list_pages : 구성된 Coda 문서 내의 모든 페이지를 나열합니다.
• coda_create_page : 문서에 새 페이지를 만들고, 선택적으로 초기 마크다운 콘텐츠로 채웁니다.
• coda_get_page_content : 지정된 페이지의 콘텐츠(ID 또는 이름)를 마크다운으로 검색합니다.
• coda_replace_page_content : 지정된 페이지의 콘텐츠를 새로운 마크다운 콘텐츠로 바꿉니다.
• coda_append_page_content : 지정된 페이지의 끝에 새로운 마크다운 콘텐츠를 추가합니다.
• coda_duplicate_page : 기존 페이지의 복사본을 새 이름으로 만듭니다.
• coda_rename_page : 기존 페이지의 이름을 변경합니다.

용법

다음과 같이 Cursor/Claude Desktop/기타에 MCP 서버를 추가합니다.

지엑스피1

필수 환경 변수:

• API_KEY : Coda API 키입니다. Coda 계정 설정에서 생성할 수 있습니다.

이 MCP 서버는 다음과 같이 Docker에서도 사용할 수 있습니다.

로컬 설정

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 사양이 변경되는 경우)