GW X Research MCP

ChatGPT용 읽기 전용 MCP 도구입니다. GPT는 사용자와 대화하고 2차 분석을 담당하며, Grok은 xAI의 x_search를 통해 지정된 X 블로거의 게시물과 스레드를 검색합니다.

macOS + Codex 원클릭 설치

Node.js 20.6+, Codex CLI 및 유효한 xAI API Key가 필요합니다. 아래 명령어 한 줄을 실행하면 설치 프로그램이 입력을 숨기고 Key를 검증하며, 서비스를 설치하고, 부팅 시 자동 시작을 설정하고, Codex에 등록합니다:

(tmp="$(mktemp)" && trap 'rm -f "$tmp"' EXIT && curl -fsSL --retry 3 -o "$tmp" https://raw.githubusercontent.com/wzh605574547gin/gw-x-research-mcp/a7606e567a8fedfb64126db3554ffdb4279ef2a7/install.sh && echo "b77d2ea593ab97496b00732d78b1877f2e9fd0970f11830e9a298f79a0cef7cb  $tmp" | shasum -a 256 -c - && bash "$tmp")

설치 프로그램은 자체 SHA-256을 검증하고 v1.0.0에 해당하는 소스 코드 commit을 확인합니다. 설치 완료 후 Codex를 재시작하고 /mcp로 gw_x_research를 확인하세요. 기본적으로 127.0.0.1만 수신하며, API Key는 권한이 0600인 로컬 .env 파일에 저장되며 Codex 구성에는 기록되지 않습니다.

스크립트를 먼저 검토하는 것을 선호한다면 install.sh을 먼저 열어 확인한 후 위 명령어를 실행하세요. v1.0.0 원클릭 설치 프로그램은 신규 설치만 지원합니다. 이미 설치 디렉터리가 존재하면 안전하게 종료됩니다.

Related MCP server: mcp-x-intelligence

제공 기능

• 1–20개의 X 계정으로 제한하며, 다른 블로거의 게시물이 섞이지 않습니다.

• 주제, 시작/종료 날짜로 검색할 수 있습니다.

• 트윗의 이미지를 분석할 수 있습니다.

• 중국어 연구 보고서, 원문 링크 및 검색 범위를 반환합니다.

• 사용자의 X 계정에 로그인하지 않으며, 게시, 좋아요, 팔로우를 하지 않습니다.

참고: x_search는 연구용 검색으로, 계정 기록의 완전한 내보내기와 동일하지 않습니다. 도구는 결과가 완전한 아카이브가 아님을 명확히 표시합니다.

1단계: xAI API Key 준비

1. https://console.x.ai/을 엽니다.

2. API Key를 생성하고 API 계정에 잔액을 충전합니다.

3. Key를 채팅에 보내지 마세요.

2단계: Mac 로컬에서 시작

Node.js 20.6 이상이 필요합니다. 터미널에서 이 디렉터리로 이동한 후 다음을 실행합니다:

npm install
cp .env.example .env

.env 파일을 열고 아래 줄을 실제 Key로 변경합니다:

XAI_API_KEY=xai-your-api-key

최초 로컬 테스트 시에는 .env의 MCP_ACCESS_TOKEN을 임시로 삭제하거나 주석 처리한 후 다음을 실행하는 것이 좋습니다:

set -a
source .env
set +a
npm start

브라우저에서 http://localhost:3000/health을 열고 "ok":true가 표시되면 서비스가 시작된 것입니다.

3단계: ChatGPT 연동

개인 사용 시에는 Secure MCP Tunnel을 권장합니다. 이렇게 하면 xAI Key가 Mac에 남아 있어 공개 서버가 필요 없습니다:

1. ChatGPT 웹 버전에서 "설정 → 보안 및 로그인 → 개발자 모드"를 엽니다.

2. ChatGPT Plugins로 이동하여 더하기(+)를 클릭해 연결을 생성합니다.

3. Connection에서 Tunnel을 선택하고 Tunnel이 로컬의 http://localhost:3000/mcp를 가리키도록 설정합니다.

4. 이름을 GW X Research로 입력하고 생성 후 도구 목록에 research_x_author가 나타나는지 확인합니다.

5. 새 대화를 열고 "+ → Developer mode"에서 GW X Research를 선택합니다.

계정에 Secure MCP Tunnel이 아직 없다면 Docker 컨테이너를 HTTPS를 지원하는 플랫폼에 배포할 수도 있습니다. 단, 공개 배포 시에는 반드시 신뢰할 수 있는 인증과 속도 제한을 추가해야 합니다. 인증이 없는 /mcp를 공개 네트워크에 노출하지 말고, XAI_API_KEY를 코드나 Docker 이미지에 작성하지 마세요.

바로 사용 가능한 질문 템플릿

只使用 GW X Research 的 research_x_author 工具。
检索 @博主账号 从 2026-01-01 到今天关于 AVGO 的原创分析推文和线程，深度选择 deep，最多20条。
然后由你做二次分析：
1. 按时间线还原观点变化；
2. 区分事实、推断和预测；
3. 提取最重要的多头与空头论据；
4. 检查前后矛盾；
5. 每项结论附原帖链接；
6. 明确说明搜索是否可能遗漏内容。

도구 입력

Docker

docker build -t gw-x-research-mcp .
export MCP_ACCESS_TOKEN="$(openssl rand -hex 32)"
docker run --rm -p 3000:3000 \
  -e XAI_API_KEY="$XAI_API_KEY" \
  -e HOST=0.0.0.0 \
  -e MCP_ACCESS_TOKEN="$MCP_ACCESS_TOKEN" \
  gw-x-research-mcp

컨테이너가 non-loopback 주소를 수신하면 서비스가 MCP_ACCESS_TOKEN을 강제로 요구합니다. 포트를 매핑하는 경우 방화벽, HTTPS 리버스 프록시 또는 OAuth를 통해 접근 범위를 제어하세요. 인증되지 않은 엔드포인트를 공개 네트워크에 노출하지 마세요.

로컬 확인

npm run check
npm test

제거

제거 시 먼저 Codex에서 gw_x_research를 삭제한 다음 com.gwcapital.gw-x-research-mcp LaunchAgent를 제거합니다. 마지막으로 필요에 따라 ~/.local/share/gw-x-research-mcp를 삭제합니다. .env에는 API Key가 포함되어 있으므로 삭제 전에 더 이상 필요하지 않은지 확인하세요.

비용 및 보안

• xAI는 Grok 토큰과 x_search 도구 호출 비용을 각각 계산합니다.

• 서버는 환경 변수에서만 Key를 읽습니다.

• MCP 도구는 읽기 전용으로 표시되지만, X의 콘텐츠에는 여전히 프롬프트 인젝션이 포함될 수 있습니다. 최종 결론은 원문 링크를 기준으로 확인하세요.

• 공개 네트워크에 배포하는 경우 표준 OAuth, ChatGPT Secure MCP Tunnel 또는 신뢰할 수 있는 인증 프록시를 사용하세요. MCP_ACCESS_TOKEN은 Bearer Token을 지원하는 클라이언트 또는 프록시 테스트용으로만 사용되며, 완전한 다중 사용자 인증 방식을 의미하지 않습니다.