Warpcast

Um servidor MCP para interagir com a rede social Warpcast.

Documentação

Warpcast MCP Server

Um servidor Model Context Protocol (MCP) para integração com Warpcast que permite usar o Claude para interagir com sua conta Warpcast.
A implementação agora segue o estilo de servidor FastMCP do SDK Python do MCP.

Recursos

Publicar casts na sua conta Warpcast
Ler casts do Warpcast
Pesquisar casts por palavra-chave ou hashtag
Navegar e interagir com canais
Seguir/deixar de seguir canais
Obter casts em alta

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

Uso

O mcp-warpcast-server geralmente é iniciado automaticamente pelo cliente MCP do Claude Desktop quando as ferramentas do Warpcast estão configuradas. Após o servidor iniciar, você pode pedir ao Claude para:

"Publicar um cast sobre [tópico]"
"Ler os casts mais recentes de [usuário]"
"Pesquisar casts sobre [tópico]"
"Mostrar casts em alta no Warpcast"
"Mostrar canais populares no Warpcast"
"Obter casts do canal [canal]"
"Seguir o canal [canal] para mim"

Ferramentas Disponíveis

Este servidor MCP fornece várias ferramentas que o Claude pode usar:

post-cast: Criar uma nova publicação no Warpcast (máximo de 320 caracteres)
get-user-casts: Recuperar casts recentes de um usuário específico
search-casts: Pesquisar casts por palavra-chave ou frase
get-trending-casts: Obter os casts em alta no Warpcast
get-all-channels: Listar canais disponíveis no Warpcast
get-channel: Obter informações sobre um canal específico
get-channel-casts: Obter casts de um canal específico
follow-channel: Seguir um canal
unfollow-channel: Deixar de seguir um canal

Configuração

O Claude Desktop normalmente inicia este servidor para você quando as ferramentas do Warpcast estão configuradas. As etapas abaixo só são necessárias se você quiser executar o servidor manualmente para desenvolvimento.

Crie um ambiente virtual Python (recomenda-se Python 3.11 ou mais recente):
```
python3 -m venv venv
source venv/bin/activate
```
Instale as dependências (os requisitos incluem o SDK Python do MCP):
```
pip install -r requirements.txt
```
Forneça um token da API do Warpcast:
- Faça login no Warpcast e abra Configurações > Desenvolvedor.
- Clique em Criar Token de API e copie o valor.
- Adicione WARPCAST_API_TOKEN na seção env da sua configuração do Claude Desktop.
- Se estiver iniciando o servidor manualmente, você pode exportar o token no seu shell:
```
export WARPCAST_API_TOKEN=YOUR_TOKEN
```
O servidor valida esta variável na inicialização. Se ela estiver ausente, um aviso é registrado e as solicitações autorizadas responderão com erros HTTP 500.
(Opcional) Inicie o servidor manualmente: A variável app exportada de main.py é criada usando mcp.streamable_http_app() para que possa ser servida por qualquer servidor ASGI.
```
uvicorn main:app --reload
```

O servidor expõe endpoints HTTP correspondentes às ferramentas listadas acima e um endpoint padrão /mcp fornecido pelo FastMCP.

Usando com o Claude Desktop

Siga estas etapas para acessar as ferramentas do Warpcast no aplicativo desktop do Claude:

Inicie o servidor (ou deixe o Claude iniciá-lo) usando as instruções de configuração acima.
Abra o arquivo de configuração do Claude:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Adicione o servidor Warpcast na chave mcpServers. Substitua o caminho pela localização deste repositório:

{
  "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"
      }
    }
  }
}

Especificar um url informa ao Claude Desktop para se comunicar com o servidor via HTTP usando Server-Sent Events em vez de entrada e saída padrão. Se você omitir url, o Claude Desktop usará por padrão a comunicação via entrada e saída padrão (stdio), que não funcionará com este servidor.

Salve o arquivo e reinicie o Claude Desktop. Você deve ver um ícone de martelo na entrada de chat que permite usar as ferramentas do Warpcast.

Executando Testes

Os testes unitários são escritos com pytest e usam o TestClient do FastAPI (instalado via fastapi[testclient]). Crie um ambiente virtual, instale as dependências e execute a suíte:

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

Os testes simulam a camada da API do Warpcast, portanto nenhuma conexão de rede é necessária.

Compatibilidade com MCP

Este servidor usa o SDK Python oficial do MCP e é totalmente compatível com o Model Context Protocol. Os clientes podem se conectar ao endpoint /mcp fornecido pelo FastMCP e interagir com as ferramentas definidas aqui.

Licença

Este projeto é licenciado sob a Licença MIT.