Сервер Warpcast MCP

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

Функции

• Публикуйте трансляции на своем аккаунте Warpcast

• Читайте трансляции от Warpcast

• Поиск по ключевым словам или хэштегу

• Просматривайте и взаимодействуйте с каналами

• Подписаться/отписаться от каналов

• Получите популярные касты

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

Related MCP server: Nostr MCP Server

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

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 . Замените путь на местоположение этого репозитория:

{
  "mcpServers": {
    "warpcast": {
      "command": "uvicorn",
      "args": [
        "--app-dir",
        "/ABSOLUTE/PATH/TO/mcp-warpcast-server",
        "main:app",
        "--port",
        "8000"
      ],
      "url": "http://localhost:8000/mcp",
      "env": {
        "WARPCAST_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

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

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

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

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

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
make test        # or simply `pytest`

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

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

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

Лицензия

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