Сервер MCP Coda

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

Функции

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

• coda_list_documents : выводит список всех документов, доступных пользователю.

• coda_list_pages : выводит список всех страниц в настроенном документе Coda.

• coda_create_page : создает новую страницу в документе, при необходимости заполняя ее начальным содержимым markdown.

• coda_get_page_content : извлекает содержимое указанной страницы (по идентификатору или имени) в формате markdown.

• coda_replace_page_content : заменяет содержимое указанной страницы новым содержимым markdown.

• coda_append_page_content : добавляет новый контент markdown в конец указанной страницы.

• coda_duplicate_page : Создает копию существующей страницы с новым именем.

• coda_rename_page : Переименовывает существующую страницу.

Related MCP server: Confluence MCP

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

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

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

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

• API_KEY : Ваш ключ API Coda. Вы можете сгенерировать его в настройках своего аккаунта Coda.

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

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

npx -y coda-mcp@latest

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

1. Предварительные условия:

   • Node.js

   • пнпм

2. Клонируйте репозиторий:

   git clone <repository-url>
   cd coda-mcp

3. Установить зависимости:

   pnpm install

4. Создайте проект:

   pnpm build

   Это компилирует код TypeScript в JavaScript в каталоге dist/ .

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

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

Разработка

• Линтинг: pnpm lint

• Форматирование: pnpm format

• Генерация клиента OpenAPI: pnpm openapi-ts (если спецификация API Coda изменится)