Beyond MCP Server

Un servidor extensible Model Context Protocol que proporciona accés estàndard a dades de plataformes socials i dades onchain. Actualment suporta Farcaster (a través de l'API Neynar) amb un marcador de posició per a la integració de Twitter. Més plataformes com Telegram, incloent dades onchain, s'afegiran aviat.

Característiques

• MCP Compliant: Implementa completament la especificació Model Context Protocol
• Multi-Platform: Dissenyat per suportar múltiples plataformes socials
• Extensible: Fàcil afegir nous proveïdors de plataforma
• Well-Formatted: Format de context optimitzat per a la consumició per LLM
• Flexible Transport: Suporta tant stdio com transports SSE/HTTP

Plataformes Suportades

• Farcaster: Implementació completa via Neynar API
• Twitter: Marcador de posició (no implementat)

Primer Pas

Requisits Prèvius

• Node.js 16+
• Clau API Neynar (per accedir a Farcaster) https://neynar.com/

Instal·lació

1. Clona el repositori

git clone https://github.com/yourusername/beyond-mcp-server.git
cd beyond-mcp-server

2. Instal·la les dependències

npm install

3. Crea un fitxer .env a partir de la plantilla

cp .env.example .env
# Edita .env amb les teves claus API

4. Configura les variables d'entorn

• Obligatori: Estableix NEYNAR_API_KEY al fitxer .env
• Pots obtenir una clau API Neynar a https://neynar.com/
• Sense una clau vàlida, la funcionalitat de Farcaster no funcionarà

5. Construïu i inicieu el servidor

npm run build
npm start  # Mode stdio (per defecte)
# O bé
npm run start:http  # Mode HTTP/SSE

Utilització amb Claude per a Desktop

1. Construïu el servidor

npm run build

2. Assegura't que el fitxer .env estigui correctament configurat amb les claus API

• El servidor buscarà .env en les següents ubicacions:
• Directori de treball actual
• Directori arrel del projecte
• Directori pare (fins a 3 nivells)
• També pots establir variables d'entorn directament al teu sistema

3. Afegeix el servidor a la configuració de Claude Desktop a:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "beyond-social": {
      "command": "/usr/local/bin/node",
      "args": [
        "/full/path/to/beyond-mcp-server/dist/index.js",
        "--stdio"
      ]
    }
  }
}

4. Alternativament, pots passar la clau API i altres variables d'entorn directament a la configuració de Claude Desktop (recomanat):

{
  "mcpServers": {
    "beyond-social": {
      "command": "/usr/local/bin/node",
      "args": [
        "/full/path/to/beyond-mcp-server/dist/index.js",
        "--stdio"
      ],
      "env": {
        "NEYNAR_API_KEY": "YOUR_API_KEY_HERE",
        "ENABLE_FARCASTER": "true",
        "ENABLE_TWITTER": "false"
      }
    }
  }
}

5. Reinicia Claude per a Desktop

Capacitats MCP

Recursos

• social://{platform}/{query}/search - Cerca contingut a una plataforma
• social://{platform}/user/{userId}/profile - Obtén el perfil d'un usuari
• social://{platform}/wallet/{walletAddress}/profile - Obtén el perfil d'un usuari per adreça de wallet (només Farcaster)
• social://{platform}/user/{userId}/balance - Obtén el saldo del wallet de l'usuari (només Farcaster)
  • Accepta FID numèric o nom d'usuari
  • Si es dóna un nom d'usuari, es converteix automàticament a FID abans de consultar el saldo
• social://{platform}/wallet/{walletAddress}/profile - Obtén el perfil d'un usuari per adreça de wallet
• social://{platform}/user/{userId}/content - Obtén el contingut d'un usuari
• social://{platform}/thread/{threadId} - Obtén el fil de conversa
• social://{platform}/trending - Obtén temes en tendència
• social://{platform}/trending-feed - Obtén contingut de feed en tendència amb suport multi-proveïdor (només Farcaster)
  • Proveïdors suportats: neynar (per defecte), openrank, mbd
  • Paràmetres: timeWindow (1h, 6h, 12h, 24h, 7d, 30d), limit
• social://{platform}/channels/search - Cerca canals a una plataforma (només Farcaster)
  • Paràmetres: query, limit, cursor
  • Retorna detalls del canal incloent nom, descripció, nombre de seguidors i metadades
• social://{platform}/channels/bulk-search - Cerca múltiples canals en paral·lel (només Farcaster)
  • Paràmetres: queries (array), limit, cursor
  • Retorna resultats per a cada consulta amb detalls del canal i informació de paginació

Eines

• search-content - Cerca contingut a una plataforma social
• get-user-profile - Obtén informació del perfil d'un usuari
• get-user-profile-by-wallet - Obtén el perfil d'un usuari utilitzant l'adreça del wallet (només Farcaster)
• get-user-balance - Obtén el saldo del wallet d'un usuari (només Farcaster)
  • Accepta FID numèric o nom d'usuari
  • Gestiona automàticament la conversió de nom a FID
• get-user-content - Obtén contingut d'un usuari específic
• get-thread - Obtén un fil de conversa
• get-trending-topics - Obtén els temes en tendència actuals
• getTrendingFeed - Obtén el feed en tendència amb suport multi-proveïdor (només Farcaster)
• get-wallet-profile - Obtén el perfil basat en l'adreça del wallet
• search-channels - Cerca canals a una plataforma (només Farcaster)
  • Paràmetres: query, limit, cursor
  • Retorna informació detallada del canal incloent nombre de seguidors i metadades
• search-bulk-channels - Cerca múltiples canals en paral·lel (només Farcaster)
  • Paràmetres: queries (array), limit, cursor
  • Retorna resultats per a cada consulta amb detalls del canal i informació de paginació

Prompts

• analyze-thread - Analitza un fil de xarxa social
• summarize-user-activity - Resumix l'activitat d'un usuari
• explore-trending-topics - Explora temes en tendència a una plataforma
• analyze-search-results - Analitza els resultats de la cerca d'una consulta
• explore-trending-feed - Analitza el contingut del feed en tendència entre diferents proveïdors
• get-wallet-profile - Obtén i analitza el perfil d'un usuari per adreça de wallet
• check-user-balance - Analitza el saldo i les possesses del wallet d'un usuari
  • Funciona amb entrades FID i nom d'usuari
  • Gestiona la resolució automàtica de FID per a noms d'usuari
• explore-channels - Analitza i explora canals a una plataforma
  • Proporciona informació sobre la popularitat i contingut del canal
  • Ajudar a descobrir canals rellevants segons criteris de cerca
• explore-bulk-channels - Analitza i compara múltiples canals en paral·lel
  • Cerca i compara eficaçment múltiples canals
  • Proporciona informació sobre relacions i tendències entre canals

Extensió amb Nous Proveïdors

Per afegir un nou proveïdor de plataforma social:

1. Crea un nou directori a src/providers/
2. Implementa la interfície ContentProvider
3. Registra el proveïdor al registre

Exemple:

import { ContentProvider } from '../interfaces/provider';

export class MyPlatformProvider implements ContentProvider {
  public name = 'myplatform';
  public platform = 'myplatform';
  
  // Implementa tots els mètodes requerits
}

Desenvolupament

Execució en Mode de Desenvolupament

npm run dev        # Mode stdio
npm run dev:http   # Mode HTTP

Testing

npm test

Linting

npm run lint
npm run lint:fix

Llicència

MIT

Contribució

Les contribucions són benvingudes! Si us plau, envia una Pull Request.

Changelog

[1.0.0] - 2025-Mar-10

Added

• Llançament inicial
• Integració de Farcaster via Neynar API
• Implementació del servidor compliant amb MCP
• Suport tant per a modes stdio com HTTP

[1.0.1] - 2025-Mar-19

Added

• Afegides noves eines i recursos per obtenir el perfil d'usuari amb adreça de wallet
• Afegits nous tests

[1.0.2] - 2025-Mar-21

Added

• Afegida funcionalitat per recuperar els saldos de wallet de usuaris de Farcaster per ID o nom d'usuari
• Implementat suport multi-proveïdor per al contingut del feed en tendència
• Millorat updateUserProfile amb detalls d'usuari addicionals
• Afegits tests exhaustius per garantir fiabilitat i rendiment

[1.0.3] - 2025-Mar-24

Added

• Afegit suport per a recuperar informació de canals de Farcaster tant en sol·licitud única com en massa