Каталог MCP
PhononX/cv-mcp-server

PhononX/cv-mcp-server

MCP-сервер для интеграции AI-ассистентов с Carbon Voice. Предоставляет инструменты для голосовых сообщений, управления беседами, папками и рабочими пространствами. Полезен для автоматизации общения...

README

28 инструментов

Версии

Установить сервер

Carbon Voice MCP Server

A Model Context Protocol (MCP) server implementation for integrating with Carbon Voice's API, providing AI assistants with comprehensive tools for voice messaging, conversations, and workspace management.

Carbon Voice: https://getcarbon.app

API: https://api.carbonvoice.app/docs

Features

Message Management: Create, list, and retrieve voice messages, conversation messages, and direct messages
User Operations: Search and retrieve user information
Conversation Management: Access and manage conversations and their participants
Folder Operations: Create, organize, move, and manage folders and their contents
Workspace Administration: Get workspace information
AI Actions: Run AI prompts and retrieve AI-generated responses
Attachment Support: Add link attachments to messages

Security & Compliance

This server fully complies with MCP Security Best Practices:

OAuth 2.1 Authentication: Secure authorization flow with proper token handling
HTTPS Enforcement: All remote endpoints served over HTTPS
Session Security: Cryptographically secure session management
Input Validation: Comprehensive validation of all user inputs
Rate Limiting: Built-in protection against abuse

Инструменты были проиндексированы: 11.09.2026

add_attachments_to_message

Добавляет вложения к сообщению. Чтобы добавить вложения к сообщению, необходимо указать идентификатор сообщения и сами вложения.

Параметры

idstringобязательный
linksstring[]обязательный
Array of links to be attached to the message

create_conversation_message

Отправляет сообщение в существующую беседу или любой другой объект с conversation_id. Чтобы ответить как ветка обсуждения, включи message_id в качестве "parent_id". Необходимо предоставить расшифровку или вложение.

Параметры

from_message_idstring
Message ID to be used as a base for the new message. (Optional only when from_message_type is NewMessage)
from_message_typeenum
From Message type
idstringобязательный
linksstring[]
Array of links to be attached to the message
transcriptstring
The Message transcript will be used to generate audio using text-to-speech

create_direct_message

Отправляет личное сообщение пользователю или группе пользователей. Чтобы создать личное сообщение, необходимо приложить расшифровку или ссылки.

Параметры

from_message_idstring
Message ID to be used as a base for the new message. (Optional only when from_message_type is NewMessage)
from_message_typeenum
From Message type
linksstring[]
Array of links to be attached to the message
toobjectобязательный
transcriptstring
The Message transcript will be used to generate audio using text-to-speech
workspace_idstring
The workspace ID to send the message to

create_folder

Создаёт новую папку.

Параметры

namestringобязательный
Name of the Folder
parent_folder_idstring
Parent Folder ID
typeenumобязательный
Folder type
workspace_idstringобязательный
Workspace ID

create_voicememo_message

Создаёт сообщение VoiceMemo. Чтобы создать сообщение VoiceMemo, вы должны указать стенограмму или прикрепить ссылки.

Параметры

audio_fileany
Audio file upload on multipart requests. Supported Formats: .mp3, .m4a, .wav, .aac, .ogg, .flac, .wma, .opus, .webm. (Overwrites transcript)
folder_idstring
Folder ID (not allowed when workspace_id specified is different from the folder_id)
linksstring[]
Array of links to be attached to the message
transcriptstring
The Message transcript will be used to generate audio using text-to-speech
workspace_idstring
Workspace ID (not allowed when folder_id specified is different from the folder_id)

delete_folder

Удаляет папку по её идентификатору. При удалении папки также удаляются вложенные папки и все сообщения в связанных папках. (Это необратимое действие, которое нельзя отменить, поэтому будьте внимательны.)

Параметры

idstringобязательный

get_ai_action_responsesтолько чтение

Извлекайте ранее сгенерированные ответы AI Action (Prompt), фильтруя по конкретному prompt, сообщению или ID беседы. Комбинируйте фильтры, чтобы сузить результаты, и просматривайте все ответы, сгенерированные AI, связанные с конкретным prompt, сообщением или беседой.

Параметры

channel_idstring
datestring
directionenum
limitnumber
message_idstring
prompt_idstring

get_conversationтолько чтение

Получает беседу по её идентификатору.

Параметры

idstringобязательный

get_conversation_usersтолько чтение

Получает пользователей в диалоге.

Параметры

idstringобязательный

get_current_userтолько чтение

Получает информацию о текущем пользователе.

Параметры

Без параметров.

get_folderтолько чтение

Получает папку по ID.

Параметры

datestring | null
Return only Subfolders updated based on the date and direction (must inform include_first_level_tree = true)
directionenum
Direction of the results (newer or older)
idstringобязательный
include_first_level_treeboolean
Defines if the first level of the folder tree should be returned

get_folder_with_messagesтолько чтение

Получает папку вместе с её сообщениями по идентификатору. (Возвращаются только сообщения на уровне папки.)

Параметры

idstringобязательный

get_messageтолько чтение

Получает сообщение по его ID.

Параметры

fieldsstring
Fields (optional) - Additional fields to include in the response. Possible values: conversation, creator, labels.
idstringобязательный
languagestring
Language (optional) - Original language will be used if not provided or not found.

get_recent_messagesтолько чтение

Получает самые последние сообщения, включая связанную информацию Conversation, Creator и Labels. Возвращает не более 10 сообщений.

Параметры

conversation_idstring
Conversation ID (optional)
languagestring
Language (optional) - Original language will be used if not provided or not found.

get_root_foldersтолько чтение

Перечисляет все корневые папки для указанной рабочей области, включая их названия, идентификаторы и базовую структуру, но не возвращает сводные данные. (Обязательно для указания типа сообщения: voicememo, prerecorded)

Параметры

include_all_treeboolean
Return all folders tree
sort_byenum
Field to sort by
sort_directionenum
Sort order direction
typeenumобязательный
Folder Type
workspace_idstring
Workspace ID

get_userтолько чтение

Возвращает подробную информацию о конкретном пользователе по его ID. Выдаёт полный профиль пользователя — имя, языки, настройки голоса, членство в рабочих пространствах и роли, предпочтения уведомлений, а также временные метки. Это более детальная информация, чем у search_user (который находит пользователей только по телефону, почте или имени). Используйте этот инструмент, если у вас уже есть ID пользователя и нужны все его данные.

Параметры

idstringобязательный

get_workspaces_basic_infoтолько чтение

Получает базовую информацию о рабочем пространстве.

Параметры

Без параметров.

list_ai_actionsтолько чтение

Выводит список AI-действий (промптов). Опционально можно отфильтровать по типу владельца и идентификатору рабочего пространства. Фильтрация по типу владельца, возможные значения: "user", "workspace", "system". Не используйте, если пользователь явно не запросил это.

Параметры

owner_typeenum
workspace_idstring

list_conversationsтолько чтение

Выводит список всех бесед. Возвращает упрощённое представление пользовательских бесед, в которых сообщения отправлялись или принимались за последние 6 месяцев. Каждый результат включает id, name, workspace_id и type (directMessage, customerConversation, namedConversation или asyncMeeting).

Параметры

matchenum
Match mode: any (union, default) or all (intersection). any returns conversations with at least one of the given users; all returns conversations with all of them.
user_idsstring[]
List of user IDs to filter conversations by. When omitted, all conversations for the caller are returned. Requires actual user IDs, not usernames or display names. If you only have a person's name, call search_users first (e.g. names: ["Brett"]) to resolve it to a user ID. If search_users returns more than one candidate for a name, ask the caller which person they meant instead of guessing.

list_messagesтолько чтение

Выводит список сообщений. По умолчанию возвращает последние 20 сообщений. Максимально допустимый диапазон между датами — 183 дня (6 месяцев). Все предварительно подписанные URL, возвращаемые этим инструментом, готовы к использованию. Не разбирайте, не изменяйте и не перекодируйте их — всегда предоставляйте или используйте URL в точности как получили. Чтобы получить сообщения за определённый период, используйте параметры "start_date" и "end_date". Чтобы получить сообщения за конкретную дату, используйте параметр "date". Чтобы получить сообщения от конкретного пользователя, используйте параметр "user_ids". Чтобы получить сообщения из конкретного разговора, используйте параметр "conversation_id". Чтобы получить сообщения из конкретной папки, используйте параметр "folder_id". Чтобы получить сообщения из конкретного рабочего пространства, используйте параметр "workspace_id". Чтобы получить сообщения на определённом языке, используйте параметр "language".

Параметры

conversation_idstring
Conversation ID (optional)
end_datestring
End Date range
folder_idstring
Folder ID (optional)
languagestring
Language (optional)
pagenumber
sizenumber
Max number of results per page is: 50
sort_directionenum
The field used to sort results is Creation Date
start_datestring
Start Date range
typeenum
Type (optional)
user_idsstring[]
User IDs (optional). List of user IDs to filter messages by. If not provided, all users will be included.
workspace_idstring
Workspace ID (optional)

move_folder

Перемещает папку по её ID. Перемещает папку в другую папку или в рабочее пространство.

Параметры

folder_idstring
Folder ID
idstringобязательный
workspace_idstring
Workspace ID

move_message_to_folder

Перемещает сообщение в папку по её идентификатору. Перемещает сообщение в другую папку или в рабочую область. Разрешено перемещать только сообщения следующих типов: voicememo, prerecorded.

Параметры

folder_idstring
Folder ID
message_idstringобязательный
Only allowed to add messages of type: voicememo,prerecorded
workspace_idstring
Workspace ID

run_ai_action

Запускает AI Action (Prompt) для сообщения. Вы можете запустить AI Action для сообщения по его ID или по списку ID сообщений.

Параметры

channel_idstring
ignore_existing_responseboolean
Whether to ignore existing response and generate a new one. Defaults to false.
languagestring
The language of the response. Defaults to original message.
message_idsstring[]обязательный
prompt_idstringобязательный
workspace_idstring

run_ai_action_for_shared_link

Выполняет AI-действие (подсказку) для общей ссылки. Можно выполнить AI-действие для общей ссылки по её идентификатору или списку идентификаторов общих ссылок. Также можно указать язык ответа.

Параметры

languagestring
prompt_idstringобязательный
share_link_idsstring[]обязательный

search_userтолько чтение

Ищет пользователя по номеру телефона, адресу электронной почты, ID или имени. (Чтобы найти пользователя, нужно указать номер телефона, email, ID или имя.) При поиске по имени возвращаются только те пользователи, которые есть в ваших контактах.

Параметры

emailstring
Email Address
namestring
The name of the user to search for (Only users that are part of your contacts will be returned)
phonestring
Phone Number

search_usersтолько чтение

Ищет нескольких пользователей по номерам телефонов, адресам электронной почты, идентификаторам или именам. (Для поиска пользователей необходимо указать номера телефонов, адреса электронной почты, идентификаторы или имена.) При поиске по имени возвращаются только пользователи, входящие в ваши контакты.

Параметры

emailsstring[]
Email Addresses
idsstring[]
User IDs
namesstring[]
The names of the users to search for (Only users that are part of your contacts will be returned)
phonesstring[]
Phone Numbers

summarize_conversation

Обобщает разговор.

Параметры

conversation_idstringобязательный
end_datestring
languagestring
limitnumber
message_idsstring[]
prompt_idstringобязательный
start_datestring

update_folder_name

Обновляет название папки по её идентификатору.

Параметры

idstringобязательный
namestringобязательный
New Folder Name

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "@carbonvoice/cv-mcp-server"
  ],
  "env": {
    "CARBON_VOICE_API_KEY": "your_api_key_here"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

FAQ

Для чего этот сервер?

Этот MCP-сервер соединяет ИИ-ассистентов с Carbon Voice — платформой для голосовых сообщений и чатов. Он позволяет ассистентам отправлять и читать сообщения, управлять папками, искать пользователей и выполнять другие действия с рабочим пространством через единый протокол. Разработчики используют его, чтобы голосовые функции Carbon Voice стали доступны прямо из диалогов с нейросетью.

Что он умеет?

Сервер работает с голосовыми и текстовыми сообщениями: создаёт голосовые заметки, отправляет личные сообщения и ответы в переписках, читает и выводит списки сообщений, добавляет вложения. Управляет папками - создаёт, переименовывает, перемещает, удаляет, смотрит содержимое. По разговорам получает информацию, участников, делает суммаризацию. Ищет пользователей по имени, телефону, email или id, показывает профили. Также запускает ИИ-промпты по сообщениям и общим ссылкам, возвращает ответы, показывает базовую информацию о рабочих пространствах.

Информация о сервере

Номер в рейтинге: #198
Звезд на Github: 10
Форков на Github: 6
Загрузок: 1 980
Язык реализации: TypeScript
Лицензия: неизвестно
Официальный сервер: Нет
Дата обновления данных: 03.09 в 04:52
Идентификатор: ON5KS1tUCtsXtwDj
Категории: ИИ и машинное обучение, Коммуникации, Обработка речи, Рабочее место и продуктивность