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. 저장소를 복제합니다

지엑스피1

2. 종속성 설치

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

4. 환경 변수 구성

   • 필수 : .env 파일에 NEYNAR_API_KEY 설정합니다.

   • https://neynar.com/ 에서 Neynar API 키를 얻을 수 있습니다.

   • 유효한 API 키가 없으면 Farcaster 기능이 작동하지 않습니다.

5. 서버를 빌드하고 시작합니다

Claude와 함께 데스크톱 사용

1. 서버를 빌드하세요

2. API 키로 .env 파일이 올바르게 구성되었는지 확인하세요.

   • 서버는 다음 위치에서 .env를 찾습니다.

     • 현재 작업 디렉토리

     • 프로젝트 루트 디렉토리

     • 상위 디렉토리(최대 3단계)

   • 또한 시스템에서 직접 환경 변수를 설정할 수도 있습니다.

3. Claude Desktop 구성에 서버를 추가하세요.

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

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

5. 데스크톱용 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 확인을 처리합니다.

새로운 공급자로 확장

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

1. src/providers/ 에 새 디렉토리를 만듭니다.

2. ContentProvider 인터페이스를 구현합니다

3. 레지스트리에 공급자 등록

예:

개발

개발 모드에서 실행

테스트

린팅

특허

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

• 신뢰성과 성능을 보장하기 위해 포괄적인 테스트가 추가되었습니다.