Warpcast MCP Server

Сервер Warpcast MCP

Сервер протокола контекста модели (MCP) для интеграции Warpcast, позволяющий использовать Claude для взаимодействия с вашей учетной записью Warpcast.
Реализация теперь соответствует стилю сервера FastMCP из MCP Python SDK.

Функции

• Публикуйте трансляции на своем аккаунте Warpcast
• Читайте трансляции от Warpcast
• Поиск по ключевым словам или хэштегу
• Просматривайте и взаимодействуйте с каналами
• Подписаться/отписаться от каналов
• Получите популярные касты

API Warpcast https://docs.farcaster.xyz/reference/warpcast/api

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

mcp-warpcast-server обычно автоматически запускается клиентом MCP Claude Desktop при настройке инструментов Warpcast. После запуска сервера вы можете попросить Клода:

• «Опубликовать актерский состав по [тема]»
• «Прочитать последние трансляции от [имя пользователя]»
• "Поиск актеров по [тема]"
• «Покажи мне популярные трансляции на Warpcast»
• «Покажи мне популярные каналы на Warpcast»
• "Получить трансляции с канала [канал]"
• «Подпишитесь на канал [канал] для меня»

Доступные инструменты

Этот сервер MCP предоставляет несколько инструментов, которые может использовать Клод:

1. post-cast : создать новый пост на Warpcast (макс. 320 символов)
2. get-user-casts : Получить последние трансляции от определенного пользователя
3. search-casts : Поиск кастов по ключевому слову или фразе
4. get-trending-casts : Получите актуальные в настоящее время трансляции на Warpcast
5. get-all-channels : Список доступных каналов на Warpcast
6. get-channel : Получить информацию о конкретном канале
7. get-channel-casts : Получить трансляции с определенного канала
8. follow-channel : Подписаться на канал
9. unfollow-channel : Отписаться от канала

Настраивать

Claude Desktop обычно запускает этот сервер для вас, когда настроены инструменты Warpcast. Шаги ниже необходимы только в том случае, если вы хотите запустить сервер вручную для разработки.

1. Создайте виртуальную среду Python (рекомендуется Python 3.11 или более поздняя версия):
   python3 -m venv venv source venv/bin/activate
2. Установите зависимости (требования включают MCP Python SDK):
   pip install -r requirements.txt
3. Предоставьте токен API Warpcast:
   • Войдите в Warpcast и откройте «Настройки» > «Разработчик» .
   • Нажмите «Создать токен API» и скопируйте значение.
   • Добавьте WARPCAST_API_TOKEN в раздел env конфигурации рабочего стола Claude.
   • Если вы запускаете сервер вручную, вы можете экспортировать токен в оболочку:GXP3 Сервер проверяет эту переменную при запуске. Если она отсутствует, регистрируется предупреждение, а авторизованные запросы будут отвечать ошибками HTTP 500 .
4. (Необязательно) Запустите сервер вручную: переменная app , экспортированная из main.py , создается с помощью mcp.streamable_http_app() поэтому ее может обслуживать любой сервер ASGI.
   uvicorn main:app --reload

Сервер предоставляет конечные точки HTTP, соответствующие перечисленным выше инструментам, и стандартную конечную точку /mcp , предоставляемую FastMCP.

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

Чтобы получить доступ к инструментам Warpcast из настольного приложения Клода, выполните следующие действия:

1. Запустите сервер (или позвольте Клоду запустить его), следуя инструкциям по настройке, приведенным выше.
2. Откройте файл конфигурации Claude:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
3. Добавьте сервер Warpcast в ключ mcpServers . Замените путь на местоположение этого репозитория:

Указание url сообщает Claude Desktop, что нужно взаимодействовать с сервером по HTTP, используя Server-Sent Events вместо стандартного ввода и вывода. Если вы не укажете url , Claude Desktop по умолчанию будет взаимодействовать через стандартный ввод и вывод (stdio), что не будет работать с этим сервером.

4. Сохраните файл и перезапустите Claude Desktop. Теперь вы должны увидеть значок молотка в чате, который позволяет использовать инструменты Warpcast.

Проведение тестов

Модульные тесты написаны с помощью pytest и используют TestClient FastAPI (устанавливается через fastapi[testclient] ). Создайте виртуальную среду, установите зависимости и запустите набор:

Тесты имитируют уровень API Warpcast, поэтому сетевое подключение не требуется.

Совместимость с МКП

Этот сервер использует официальный MCP Python SDK и полностью совместим с Model Context Protocol . Клиенты могут подключаться к конечной точке /mcp , предоставляемой FastMCP, и взаимодействовать с инструментами, определенными здесь.

Лицензия

Данный проект лицензирован в соответствии с лицензией MIT .