Más allá del servidor MCP

Un servidor extensible de Protocolo de Contexto de Modelo (MPP) que proporciona acceso estandarizado a datos de plataformas sociales y datos en cadena. Actualmente es compatible con Farcaster (mediante la API de Neynar) con un marcador de posición para la integración con Twitter. Próximamente se añadirán más plataformas como Telegram que incluyen datos en cadena.

Características

• Compatible con MCP : implementa completamente la especificación del Protocolo de contexto de modelo

• Multiplataforma : diseñado para admitir múltiples plataformas de redes sociales.

• Extensible : Fácil de agregar nuevos proveedores de plataforma

• Bien formateado : formato de contexto optimizado para el consumo de LLM

• Transporte flexible : admite transportes stdio y SSE/HTTP

Related MCP server: MCP URL Fetcher

Plataformas compatibles

• Farcaster : implementación completa a través de la API de Neynar

• Twitter : Marcador de posición (no implementado)

Empezando

Prerrequisitos

• Node.js 16+

• Clave API de Neynar (para acceso a Farcaster) https://neynar.com/

Instalación

1. Clonar el repositorio

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

2. Instalar dependencias

npm install

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

cp .env.example .env
# Edit .env with your API keys

4. Configurar sus variables de entorno

   • Obligatorio : Establezca NEYNAR_API_KEY en su archivo .env

   • Puede obtener una clave API de Neynar en https://neynar.com/

   • Sin una clave API válida, la funcionalidad de Farcaster no funcionará

5. Construir e iniciar el servidor

npm run build
npm start  # For stdio mode (default)
# OR
npm run start:http  # For HTTP/SSE mode

Uso con Claude para escritorio

1. Construir el servidor

npm run build

2. Asegúrese de que su archivo .env esté configurado correctamente con sus claves API

   • El servidor buscará .env en las siguientes ubicaciones:

     • Directorio de trabajo actual

     • Directorio raíz del proyecto

     • Directorios principales (hasta 3 niveles)

   • También puede configurar variables de entorno directamente en su sistema

3. Agregue el servidor a su configuración de Claude Desktop en:

• macOS: ~/Biblioteca/Soporte de aplicaciones/Claude/claude_desktop_config.json

• Ventanas: %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. Alternativamente, puede pasar la clave API y otras variables de entorno directamente en la configuración de Claude Desktop ( recomendado ):

{
  "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. Reiniciar Claude para escritorio

Capacidades de MCP

Recursos

• social://{platform}/{query}/search - Buscar contenido en una plataforma

• social://{platform}/user/{userId}/profile - Obtener el perfil del usuario

• social://{platform}/wallet/{walletAddress}/profile - Obtener el perfil del usuario por dirección de billetera (solo Farcaster)

• social://{platform}/user/{userId}/balance - Obtener el saldo de la billetera del usuario (solo Farcaster)

  • Acepta FID (numérico) o nombre de usuario

  • Si se proporciona el nombre de usuario, se convierte automáticamente a FID antes de obtener el saldo

• social://{platform}/wallet/{walletAddress}/profile - Obtener el perfil del usuario por dirección de billetera

• social://{platform}/user/{userId}/content - Obtener contenido del usuario

• social://{platform}/thread/{threadId} - Obtener el hilo de conversación

• social://{platform}/trending - Obtenga temas de tendencia

• social://{platform}/trending-feed - Obtén contenido de feed de tendencias con soporte para múltiples proveedores (solo Farcaster)

  • Proveedores compatibles: neynar (predeterminado), openrank, mbd

  • Parámetros: timeWindow (1h, 6h, 12h, 24h, 7d, 30d), límite

Herramientas

• search-content - Busca contenido en una plataforma social

• get-user-profile - Obtener la información del perfil de un usuario

• get-user-profile-by-wallet : obtiene el perfil del usuario usando la dirección de la billetera (solo Farcaster)

• get-user-balance : obtiene el saldo de la billetera del usuario (solo Farcaster)

  • Acepta FID (numérico) o nombre de usuario

  • Maneja automáticamente la conversión de nombre de usuario a FID

• get-user-content - Obtener contenido de un usuario específico

• get-thread - Obtener un hilo de conversación

• get-trending-topics - Obtenga información sobre temas de tendencia actuales

• getTrendingFeed : obtén noticias de tendencias con soporte para múltiples proveedores (solo Farcaster)

• get-wallet-profile - Obtener perfil según la dirección de la billetera

Indicaciones

• analyze-thread - Analizar un hilo de redes sociales

• summarize-user-activity - Resumir la actividad de un usuario

• explore-trending-topics : explora temas de tendencia en una plataforma

• analyze-search-results : analizar los resultados de búsqueda de una consulta

• explore-trending-feed : analiza el contenido de tendencias de diferentes proveedores

• get-wallet-profile : obtiene y analiza el perfil del usuario por dirección de billetera

• check-user-balance : analiza el saldo y las tenencias de la billetera del usuario

  • Funciona con entradas de FID y nombre de usuario

  • Maneja la resolución automática de FID para nombres de usuario

Ampliación con nuevos proveedores

Para agregar un nuevo proveedor de plataforma social:

1. Crea un nuevo directorio en src/providers/

2. Implementar la interfaz ContentProvider

3. Registrar al proveedor en el registro

Ejemplo:

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

export class MyPlatformProvider implements ContentProvider {
  public name = 'myplatform';
  public platform = 'myplatform';
  
  // Implement all required methods
}

Desarrollo

Ejecutando en modo de desarrollo

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

Pruebas

npm test

Pelusa

npm run lint
npm run lint:fix

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Registro de cambios

Todos los cambios notables en este proyecto se documentarán en este archivo.

[1.0.0] - 10 de marzo de 2025

Agregado

• Lanzamiento inicial

• Integración de Farcaster a través de la API de Neynar

• Implementación de servidor compatible con MCP

• Compatibilidad con los modos stdio y HTTP

[1.0.1] - 19 de marzo de 2025

Agregado

• Se agregaron nuevas herramientas y recursos para obtener el perfil del usuario con la dirección de la billetera.

• Se agregaron nuevas pruebas

[1.0.2] - 21 de marzo de 2025

Agregado

• Se agregó funcionalidad para recuperar los saldos de la billetera de los usuarios de Farcaster mediante ID o nombre de usuario

• Se implementó la compatibilidad con múltiples proveedores para el contenido de tendencias del feed.

• Actualización mejorada de UserProfile con detalles de usuario adicionales

• Se agregaron pruebas integrales para garantizar la confiabilidad y el rendimiento.