MCP 서버 너머

소셜 플랫폼 데이터와 온체인 데이터에 대한 표준화된 액세스를 제공하는 확장 가능한 모델 컨텍스트 프로토콜 서버입니다. 현재 Farcaster(Neynar API를 통해)를 지원하며, 트위터 통합을 위한 플레이스홀더도 제공합니다. Telegram 등 온체인 데이터를 포함하는 더 많은 플랫폼이 곧 추가될 예정입니다.

특징

MCP 호환 : 모델 컨텍스트 프로토콜 사양을 완벽하게 구현합니다.
다중 플랫폼 : 여러 소셜 미디어 플랫폼을 지원하도록 설계되었습니다.
확장 가능 : 새로운 플랫폼 공급자를 쉽게 추가할 수 있습니다.
Well-Formatted : LLM 사용을 위한 최적화된 컨텍스트 형식
유연한 전송 : stdio 및 SSE/HTTP 전송을 모두 지원합니다.

지원 플랫폼

Farcaster : Neynar API를 통한 전체 구현
Twitter : 플레이스홀더(구현되지 않음)

시작하기

필수 조건

노드.js 16+
Neynar API 키(Farcaster 액세스용) https://neynar.com/

설치

저장소를 복제합니다

지엑스피1

종속성 설치

npm install

템플릿에서 .env 파일을 만듭니다.

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

환경 변수 구성
- 필수 : .env 파일에 NEYNAR_API_KEY 설정합니다.
- https://neynar.com/ 에서 Neynar API 키를 얻을 수 있습니다.
- 유효한 API 키가 없으면 Farcaster 기능이 작동하지 않습니다.
서버를 빌드하고 시작합니다

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

Claude와 함께 데스크톱 사용

서버를 빌드하세요

npm run build

API 키로 .env 파일이 올바르게 구성되었는지 확인하세요.
- 서버는 다음 위치에서 .env를 찾습니다.
  - 현재 작업 디렉토리
  - 프로젝트 루트 디렉토리
  - 상위 디렉토리(최대 3단계)
- 또한 시스템에서 직접 환경 변수를 설정할 수도 있습니다.
Claude Desktop 구성에 서버를 추가하세요.

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

또는 Claude Desktop 구성에서 API 키와 기타 환경 변수를 직접 전달할 수 있습니다( 권장 ):

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

데스크톱용 Claude 재시작

MCP 기능

자원

social://{platform}/{query}/search - 플랫폼에서 콘텐츠 검색
social://{platform}/user/{userId}/profile - 사용자 프로필 가져오기
social://{platform}/wallet/{walletAddress}/profile - 지갑 주소로 사용자 프로필 가져오기(Farcaster 전용)
social://{platform}/user/{userId}/balance - 사용자의 지갑 잔액을 가져옵니다(Farcaster 전용)
- FID(숫자) 또는 사용자 이름을 허용합니다.
- 사용자 이름이 제공된 경우 잔액을 가져오기 전에 자동으로 FID로 변환됩니다.
social://{platform}/wallet/{walletAddress}/profile - 지갑 주소로 사용자 프로필 가져오기
social://{platform}/user/{userId}/content - 사용자 콘텐츠 가져오기
social://{platform}/thread/{threadId} - 대화 스레드 가져오기
social://{platform}/trending - 트렌드 주제 가져오기
social://{platform}/trending-feed - 다중 공급자 지원을 통해 트렌드 피드 콘텐츠를 받으세요(Farcaster 전용)
- 지원 공급자: neynar(기본값), openrank, mbd
- 매개변수: timeWindow(1시간, 6시간, 12시간, 24시간, 7일, 30일), limit

도구

search-content - 소셜 플랫폼에서 콘텐츠 검색
get-user-profile - 사용자 프로필 정보 가져오기
get-user-profile-by-wallet - 지갑 주소를 사용하여 사용자 프로필 가져오기(Farcaster 전용)
get-user-balance - 사용자의 지갑 잔액을 가져옵니다(Farcaster 전용)
- FID(숫자) 또는 사용자 이름을 허용합니다.
- 사용자 이름을 FID로 자동 변환합니다.
get-user-content - 특정 사용자의 콘텐츠 가져오기
get-thread - 대화 스레드 가져오기
get-trending-topics - 현재 인기 있는 주제 가져오기
getTrendingFeed - 다중 공급자 지원을 통해 트렌드 피드 받기(Farcaster 전용)
get-wallet-profile - 지갑 주소 기반 프로필 가져오기

프롬프트

analyze-thread - 소셜 미디어 스레드 분석
summarize-user-activity - 사용자 활동을 요약합니다.
explore-trending-topics - 플랫폼에서 인기 있는 주제 탐색
analyze-search-results - 쿼리에 대한 검색 결과 분석
explore-trending-feed - 다양한 공급업체의 트렌드 피드 콘텐츠 분석
get-wallet-profile - 지갑 주소로 사용자 프로필을 가져오고 분석합니다.
check-user-balance - 사용자의 지갑 잔액 및 보유 자산 분석
- FID와 사용자 이름 입력 모두에서 작동합니다.
- 사용자 이름에 대한 자동 FID 확인을 처리합니다.

새로운 공급자로 확장

새로운 소셜 플랫폼 제공자를 추가하려면:

src/providers/ 에 새 디렉토리를 만듭니다.
ContentProvider 인터페이스를 구현합니다
레지스트리에 공급자 등록

예:

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

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

개발

개발 모드에서 실행

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

테스트

npm test

린팅

npm run lint
npm run lint:fix

특허

MIT

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

변경 사항

이 프로젝트의 모든 주요 변경 사항은 이 파일에 기록됩니다.

[1.0.0] - 2025년 3월 10일

추가됨

최초 출시
Neynar API를 통한 Farcaster 통합
MCP 호환 서버 구현
stdio 및 HTTP 모드 모두 지원

[1.0.1] - 2025년 3월 19일

추가됨

지갑 주소로 사용자 프로필을 가져오기 위한 새로운 도구와 리소스가 추가되었습니다.
새로운 테스트 추가됨

[1.0.2] - 2025년 3월 21일

추가됨

ID 또는 사용자 이름을 통해 Farcaster 사용자의 지갑 잔액을 검색하는 기능이 추가되었습니다.
트렌드 피드 콘텐츠에 대한 다중 공급자 지원 구현
추가 사용자 세부 정보가 포함된 향상된 updateUserProfile
신뢰성과 성능을 보장하기 위해 포괄적인 테스트가 추가되었습니다.

Beyond MCP Server

Integrations