Сервер MCP Coda

Этот проект реализует сервер Model Context Protocol (MCP), который действует как мост для взаимодействия с API Coda . Он позволяет клиенту MCP (например, помощнику AI) выполнять действия с определенным документом Coda, например, перечисление, создание, чтение, обновление, дублирование и переименование страниц.

Функции

Сервер предоставляет клиенту MCP следующие инструменты:

list-pages : выводит список всех страниц настроенного документа Coda.
create-page : создает новую страницу в документе, при необходимости заполняя ее начальным содержимым Markdown.
get-page-content : извлекает содержимое указанной страницы (по идентификатору или имени) в виде разметки.
replace-page-content : заменяет содержимое указанной страницы новым содержимым markdown.
append-page-content : добавляет новый контент Markdown в конец указанной страницы.
duplicate-page : Создает копию существующей страницы с новым именем.
rename-page : Переименовывает существующую страницу.

Использование

Добавьте сервер MCP в Cursor/Claude Desktop и т. д. следующим образом:

{
  "mcpServers": {
    "coda": {
      "command": "npx",
      "args": ["-y", "coda-mcp@latest"],
      "env": {
        "API_KEY": "...",
        "DOC_ID": "..."
      }
    }
  }
}

Необходимые переменные среды:

API_KEY : Ваш ключ API Coda. Вы можете сгенерировать его в настройках своего аккаунта Coda.
DOC_ID : Идентификатор документа Coda, с которым вы хотите, чтобы сервер взаимодействовал. Вы можете найти его в URL документа (часть после _d ).

Этот сервер MCP также доступен с Docker, например:

{
  "mcpServers": {
    "coda": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "API_KEY", "-e", "DOC_ID", "reaperberri/coda-mcp:latest"],
      "env": {
        "API_KEY": "...",
        "DOC_ID": "..."
      }
    }
  }
}

npx -y coda-mcp@latest

Локальная настройка

Предварительные условия:
- Node.js
- пнпм
Клонируйте репозиторий:
git clone <repository-url> cd coda-mcp
Установите зависимости:
pnpm install
Создайте проект:
pnpm build
Это компилирует код TypeScript в JavaScript в каталоге dist/ .

Запуск сервера

Сервер MCP взаимодействует через стандартный ввод/вывод (stdio). Чтобы запустить его, установите переменные окружения и запустите скомпилированный файл JavaScript - dist/index.js .

Разработка

Линтинг: pnpm lint
Форматирование: pnpm format
Генерация клиента OpenAPI: pnpm openapi-ts (если спецификация API Coda изменится)

Coda MCP Server

Integrations