X (Twitter)

Name: X (Twitter)
Author: Role1776

作者：Role1776版本 0.1.1i★ –i在你的电脑上运行

注册名称io.github.Role1776/mcp-x

安装

概览

作者提供的说明（英文原文）

Search, read and publish X posts and manage users, lists and media via the X API v2.

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数：意见、测量和人气是不同的东西。

用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
我们的基础检查i1 项中通过 1 项依据公开信息检查；尚未扫描代码
使用情况i尚未统计★ –

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

连接方式: 在你的电脑上运行
传输方式: stdio
分类: 营销与社交媒体
你需要填写：X_API_KEY, X_API_KEY_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET, MEDIA_ROOT

安装

选择你使用的 AI 应用，然后复制设置。

安装之前

基础检查：1 项中通过 1 项
在你的电脑上运行，拥有你的用户账户的权限（文件、网络、应用）。
需要你自己填写： X_API_KEY, X_API_KEY_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET, MEDIA_ROOT, MCP_TRANSPORT, MCP_NAME, MCP_PATH, SERVER_PORT, SERVER_READ_TIMEOUT, SERVER_WRITE_TIMEOUT, LOG_MODE, MAX_IDLE_CONNS_PER_HOST, X_DEBUG, POSTS_MAX_QUERIES, POSTS_MAX_USERNAMES, POSTS_MAX_IDS, POSTS_DEFAULT_RESULTS, POSTS_MAX_RESULTS, POSTS_DEFAULT_DAYS, POSTS_MAX_DAYS, POSTS_DEFAULT_TIMEOUT_MS, POSTS_MIN_TIMEOUT_MS, POSTS_MAX_TIMEOUT_MS, USERS_MAX_USERNAMES, USERS_MAX_IDS, USERS_DEFAULT_RESULTS, USERS_MAX_RESULTS, USERS_DEFAULT_TIMEOUT_MS, USERS_MIN_TIMEOUT_MS, USERS_MAX_TIMEOUT_MS, LISTS_DEFAULT_RESULTS, LISTS_MAX_RESULTS, LISTS_DEFAULT_TIMEOUT_MS, LISTS_MIN_TIMEOUT_MS, LISTS_MAX_TIMEOUT_MS, MEDIA_CHUNK_BYTES, MEDIA_POLL_INTERVAL_MS, MEDIA_DEFAULT_TIMEOUT_MS, MEDIA_MIN_TIMEOUT_MS, MEDIA_MAX_TIMEOUT_MS

标为机密的值是你账户的钥匙。千万不要分享给别人，也不要粘贴到聊天里。

你需要

Docker已安装 Docker

你用的是哪个应用？

ClaudeClaude CodeCursorVS CodeChatGPT

在上方选择你的应用。我们会记住它，下次按钮会显示“安装到 …”。

下载作者的 .mcpb 文件

链接指向作者自己的文件；我们不托管也不重新打包它。打开文件后，Claude Desktop 会进行安装。

在终端中运行这条命令

claude mcp add x --env X_API_KEY=your-value --env X_API_KEY_SECRET=your-value --env X_ACCESS_TOKEN=your-value --env X_ACCESS_TOKEN_SECRET=your-value --env MEDIA_ROOT=your-value --env MCP_TRANSPORT=your-value --env MCP_NAME=your-value --env MCP_PATH=your-value --env SERVER_PORT=your-value --env SERVER_READ_TIMEOUT=your-value --env SERVER_WRITE_TIMEOUT=your-value --env LOG_MODE=your-value --env MAX_IDLE_CONNS_PER_HOST=your-value --env X_DEBUG=your-value --env POSTS_MAX_QUERIES=your-value --env POSTS_MAX_USERNAMES=your-value --env POSTS_MAX_IDS=your-value --env POSTS_DEFAULT_RESULTS=your-value --env POSTS_MAX_RESULTS=your-value --env POSTS_DEFAULT_DAYS=your-value --env POSTS_MAX_DAYS=your-value --env POSTS_DEFAULT_TIMEOUT_MS=your-value --env POSTS_MIN_TIMEOUT_MS=your-value --env POSTS_MAX_TIMEOUT_MS=your-value --env USERS_MAX_USERNAMES=your-value --env USERS_MAX_IDS=your-value --env USERS_DEFAULT_RESULTS=your-value --env USERS_MAX_RESULTS=your-value --env USERS_DEFAULT_TIMEOUT_MS=your-value --env USERS_MIN_TIMEOUT_MS=your-value --env USERS_MAX_TIMEOUT_MS=your-value --env LISTS_DEFAULT_RESULTS=your-value --env LISTS_MAX_RESULTS=your-value --env LISTS_DEFAULT_TIMEOUT_MS=your-value --env LISTS_MIN_TIMEOUT_MS=your-value --env LISTS_MAX_TIMEOUT_MS=your-value --env MEDIA_CHUNK_BYTES=your-value --env MEDIA_POLL_INTERVAL_MS=your-value --env MEDIA_DEFAULT_TIMEOUT_MS=your-value --env MEDIA_MIN_TIMEOUT_MS=your-value --env MEDIA_MAX_TIMEOUT_MS=your-value -- docker run -i --rm -e X_API_KEY -e X_API_KEY_SECRET -e X_ACCESS_TOKEN -e X_ACCESS_TOKEN_SECRET -e MEDIA_ROOT -e MCP_TRANSPORT -e MCP_NAME -e MCP_PATH -e SERVER_PORT -e SERVER_READ_TIMEOUT -e SERVER_WRITE_TIMEOUT -e LOG_MODE -e MAX_IDLE_CONNS_PER_HOST -e X_DEBUG -e POSTS_MAX_QUERIES -e POSTS_MAX_USERNAMES -e POSTS_MAX_IDS -e POSTS_DEFAULT_RESULTS -e POSTS_MAX_RESULTS -e POSTS_DEFAULT_DAYS -e POSTS_MAX_DAYS -e POSTS_DEFAULT_TIMEOUT_MS -e POSTS_MIN_TIMEOUT_MS -e POSTS_MAX_TIMEOUT_MS -e USERS_MAX_USERNAMES -e USERS_MAX_IDS -e USERS_DEFAULT_RESULTS -e USERS_MAX_RESULTS -e USERS_DEFAULT_TIMEOUT_MS -e USERS_MIN_TIMEOUT_MS -e USERS_MAX_TIMEOUT_MS -e LISTS_DEFAULT_RESULTS -e LISTS_MAX_RESULTS -e LISTS_DEFAULT_TIMEOUT_MS -e LISTS_MIN_TIMEOUT_MS -e LISTS_MAX_TIMEOUT_MS -e MEDIA_CHUNK_BYTES -e MEDIA_POLL_INTERVAL_MS -e MEDIA_DEFAULT_TIMEOUT_MS -e MEDIA_MIN_TIMEOUT_MS -e MEDIA_MAX_TIMEOUT_MS ghcr.io/role1776/mcp-x:0.1.1

运行前请先填写空着的值。

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json，或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "x": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "X_API_KEY",
        "-e",
        "X_API_KEY_SECRET",
        "-e",
        "X_ACCESS_TOKEN",
        "-e",
        "X_ACCESS_TOKEN_SECRET",
        "-e",
        "MEDIA_ROOT",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "MCP_NAME",
        "-e",
        "MCP_PATH",
        "-e",
        "SERVER_PORT",
        "-e",
        "SERVER_READ_TIMEOUT",
        "-e",
        "SERVER_WRITE_TIMEOUT",
        "-e",
        "LOG_MODE",
        "-e",
        "MAX_IDLE_CONNS_PER_HOST",
        "-e",
        "X_DEBUG",
        "-e",
        "POSTS_MAX_QUERIES",
        "-e",
        "POSTS_MAX_USERNAMES",
        "-e",
        "POSTS_MAX_IDS",
        "-e",
        "POSTS_DEFAULT_RESULTS",
        "-e",
        "POSTS_MAX_RESULTS",
        "-e",
        "POSTS_DEFAULT_DAYS",
        "-e",
        "POSTS_MAX_DAYS",
        "-e",
        "POSTS_DEFAULT_TIMEOUT_MS",
        "-e",
        "POSTS_MIN_TIMEOUT_MS",
        "-e",
        "POSTS_MAX_TIMEOUT_MS",
        "-e",
        "USERS_MAX_USERNAMES",
        "-e",
        "USERS_MAX_IDS",
        "-e",
        "USERS_DEFAULT_RESULTS",
        "-e",
        "USERS_MAX_RESULTS",
        "-e",
        "USERS_DEFAULT_TIMEOUT_MS",
        "-e",
        "USERS_MIN_TIMEOUT_MS",
        "-e",
        "USERS_MAX_TIMEOUT_MS",
        "-e",
        "LISTS_DEFAULT_RESULTS",
        "-e",
        "LISTS_MAX_RESULTS",
        "-e",
        "LISTS_DEFAULT_TIMEOUT_MS",
        "-e",
        "LISTS_MIN_TIMEOUT_MS",
        "-e",
        "LISTS_MAX_TIMEOUT_MS",
        "-e",
        "MEDIA_CHUNK_BYTES",
        "-e",
        "MEDIA_POLL_INTERVAL_MS",
        "-e",
        "MEDIA_DEFAULT_TIMEOUT_MS",
        "-e",
        "MEDIA_MIN_TIMEOUT_MS",
        "-e",
        "MEDIA_MAX_TIMEOUT_MS",
        "ghcr.io/role1776/mcp-x:0.1.1"
      ],
      "env": {
        "X_API_KEY": "your-value",
        "X_API_KEY_SECRET": "your-value",
        "X_ACCESS_TOKEN": "your-value",
        "X_ACCESS_TOKEN_SECRET": "your-value",
        "MEDIA_ROOT": "your-value",
        "MCP_TRANSPORT": "your-value",
        "MCP_NAME": "your-value",
        "MCP_PATH": "your-value",
        "SERVER_PORT": "your-value",
        "SERVER_READ_TIMEOUT": "your-value",
        "SERVER_WRITE_TIMEOUT": "your-value",
        "LOG_MODE": "your-value",
        "MAX_IDLE_CONNS_PER_HOST": "your-value",
        "X_DEBUG": "your-value",
        "POSTS_MAX_QUERIES": "your-value",
        "POSTS_MAX_USERNAMES": "your-value",
        "POSTS_MAX_IDS": "your-value",
        "POSTS_DEFAULT_RESULTS": "your-value",
        "POSTS_MAX_RESULTS": "your-value",
        "POSTS_DEFAULT_DAYS": "your-value",
        "POSTS_MAX_DAYS": "your-value",
        "POSTS_DEFAULT_TIMEOUT_MS": "your-value",
        "POSTS_MIN_TIMEOUT_MS": "your-value",
        "POSTS_MAX_TIMEOUT_MS": "your-value",
        "USERS_MAX_USERNAMES": "your-value",
        "USERS_MAX_IDS": "your-value",
        "USERS_DEFAULT_RESULTS": "your-value",
        "USERS_MAX_RESULTS": "your-value",
        "USERS_DEFAULT_TIMEOUT_MS": "your-value",
        "USERS_MIN_TIMEOUT_MS": "your-value",
        "USERS_MAX_TIMEOUT_MS": "your-value",
        "LISTS_DEFAULT_RESULTS": "your-value",
        "LISTS_MAX_RESULTS": "your-value",
        "LISTS_DEFAULT_TIMEOUT_MS": "your-value",
        "LISTS_MIN_TIMEOUT_MS": "your-value",
        "LISTS_MAX_TIMEOUT_MS": "your-value",
        "MEDIA_CHUNK_BYTES": "your-value",
        "MEDIA_POLL_INTERVAL_MS": "your-value",
        "MEDIA_DEFAULT_TIMEOUT_MS": "your-value",
        "MEDIA_MIN_TIMEOUT_MS": "your-value",
        "MEDIA_MAX_TIMEOUT_MS": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "x": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "X_API_KEY",
        "-e",
        "X_API_KEY_SECRET",
        "-e",
        "X_ACCESS_TOKEN",
        "-e",
        "X_ACCESS_TOKEN_SECRET",
        "-e",
        "MEDIA_ROOT",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "MCP_NAME",
        "-e",
        "MCP_PATH",
        "-e",
        "SERVER_PORT",
        "-e",
        "SERVER_READ_TIMEOUT",
        "-e",
        "SERVER_WRITE_TIMEOUT",
        "-e",
        "LOG_MODE",
        "-e",
        "MAX_IDLE_CONNS_PER_HOST",
        "-e",
        "X_DEBUG",
        "-e",
        "POSTS_MAX_QUERIES",
        "-e",
        "POSTS_MAX_USERNAMES",
        "-e",
        "POSTS_MAX_IDS",
        "-e",
        "POSTS_DEFAULT_RESULTS",
        "-e",
        "POSTS_MAX_RESULTS",
        "-e",
        "POSTS_DEFAULT_DAYS",
        "-e",
        "POSTS_MAX_DAYS",
        "-e",
        "POSTS_DEFAULT_TIMEOUT_MS",
        "-e",
        "POSTS_MIN_TIMEOUT_MS",
        "-e",
        "POSTS_MAX_TIMEOUT_MS",
        "-e",
        "USERS_MAX_USERNAMES",
        "-e",
        "USERS_MAX_IDS",
        "-e",
        "USERS_DEFAULT_RESULTS",
        "-e",
        "USERS_MAX_RESULTS",
        "-e",
        "USERS_DEFAULT_TIMEOUT_MS",
        "-e",
        "USERS_MIN_TIMEOUT_MS",
        "-e",
        "USERS_MAX_TIMEOUT_MS",
        "-e",
        "LISTS_DEFAULT_RESULTS",
        "-e",
        "LISTS_MAX_RESULTS",
        "-e",
        "LISTS_DEFAULT_TIMEOUT_MS",
        "-e",
        "LISTS_MIN_TIMEOUT_MS",
        "-e",
        "LISTS_MAX_TIMEOUT_MS",
        "-e",
        "MEDIA_CHUNK_BYTES",
        "-e",
        "MEDIA_POLL_INTERVAL_MS",
        "-e",
        "MEDIA_DEFAULT_TIMEOUT_MS",
        "-e",
        "MEDIA_MIN_TIMEOUT_MS",
        "-e",
        "MEDIA_MAX_TIMEOUT_MS",
        "ghcr.io/role1776/mcp-x:0.1.1"
      ],
      "env": {
        "X_API_KEY": "your-value",
        "X_API_KEY_SECRET": "your-value",
        "X_ACCESS_TOKEN": "your-value",
        "X_ACCESS_TOKEN_SECRET": "your-value",
        "MEDIA_ROOT": "your-value",
        "MCP_TRANSPORT": "your-value",
        "MCP_NAME": "your-value",
        "MCP_PATH": "your-value",
        "SERVER_PORT": "your-value",
        "SERVER_READ_TIMEOUT": "your-value",
        "SERVER_WRITE_TIMEOUT": "your-value",
        "LOG_MODE": "your-value",
        "MAX_IDLE_CONNS_PER_HOST": "your-value",
        "X_DEBUG": "your-value",
        "POSTS_MAX_QUERIES": "your-value",
        "POSTS_MAX_USERNAMES": "your-value",
        "POSTS_MAX_IDS": "your-value",
        "POSTS_DEFAULT_RESULTS": "your-value",
        "POSTS_MAX_RESULTS": "your-value",
        "POSTS_DEFAULT_DAYS": "your-value",
        "POSTS_MAX_DAYS": "your-value",
        "POSTS_DEFAULT_TIMEOUT_MS": "your-value",
        "POSTS_MIN_TIMEOUT_MS": "your-value",
        "POSTS_MAX_TIMEOUT_MS": "your-value",
        "USERS_MAX_USERNAMES": "your-value",
        "USERS_MAX_IDS": "your-value",
        "USERS_DEFAULT_RESULTS": "your-value",
        "USERS_MAX_RESULTS": "your-value",
        "USERS_DEFAULT_TIMEOUT_MS": "your-value",
        "USERS_MIN_TIMEOUT_MS": "your-value",
        "USERS_MAX_TIMEOUT_MS": "your-value",
        "LISTS_DEFAULT_RESULTS": "your-value",
        "LISTS_MAX_RESULTS": "your-value",
        "LISTS_DEFAULT_TIMEOUT_MS": "your-value",
        "LISTS_MIN_TIMEOUT_MS": "your-value",
        "LISTS_MAX_TIMEOUT_MS": "your-value",
        "MEDIA_CHUNK_BYTES": "your-value",
        "MEDIA_POLL_INTERVAL_MS": "your-value",
        "MEDIA_DEFAULT_TIMEOUT_MS": "your-value",
        "MEDIA_MIN_TIMEOUT_MS": "your-value",
        "MEDIA_MAX_TIMEOUT_MS": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

这个服务器在你的电脑上运行，而 ChatGPT 只能连接互联网上的服务器。请选择其他应用。

你的选择通过 Cookie 保存在这台设备上，无需账户。

需要你填写的值

X_API_KEY 机密必填 env
OAuth 1.0a consumer key. developer.x.com -> your project -> your app -> Keys and tokens.
X_API_KEY_SECRET 机密必填 env
OAuth 1.0a consumer secret, issued together with X_API_KEY.
X_ACCESS_TOKEN 机密必填 env
User access token. Set the app permissions to Read and Write BEFORE generating it: a token keeps the permissions it was created with, and a read-only one fails every write until it is regenerated.
X_ACCESS_TOKEN_SECRET 机密必填 env
User access token secret, issued together with X_ACCESS_TOKEN.
MEDIA_ROOT 必填 env
Absolute path to an existing directory - the only one x_media_upload may read files from. Anything outside it is refused, symlinks included. Checked at startup.
MCP_TRANSPORT env
stdio (client spawns the process) or http (streamable HTTP listener).
MCP_NAME env
Server name reported in the MCP initialize handshake.
MCP_PATH env
HTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.
SERVER_PORT env
TCP port to listen on. Used only when MCP_TRANSPORT=http.
SERVER_READ_TIMEOUT env
HTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.
SERVER_WRITE_TIMEOUT env
HTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.
LOG_MODE env
local (text, debug) or prod (JSON, info). Logs go to stderr.
MAX_IDLE_CONNS_PER_HOST env
Idle connections the outbound HTTP client keeps per host.
X_DEBUG env
Log the raw requests sent to the X API. Verbose; the output can contain request details, so keep it off outside debugging.
POSTS_MAX_QUERIES env
Queries accepted in one x_posts_search or x_posts_count call.
POSTS_MAX_USERNAMES env
Usernames accepted in one x_posts_by_user call.
POSTS_MAX_IDS env
Post ids accepted in one x_posts_lookup call. The X API caps this at 100.
POSTS_DEFAULT_RESULTS env
Posts returned per query when the call does not ask for a count. Every post returned is billed.
POSTS_MAX_RESULTS env
Upper bound for posts per query. The X API caps this at 100.
POSTS_DEFAULT_DAYS env
How far back post searches look when the call does not say, in days.
POSTS_MAX_DAYS env
Furthest back a post search may look, in days. Recent search cannot exceed 7.
POSTS_DEFAULT_TIMEOUT_MS env
Timeout for a posts call in milliseconds when the call does not request one.
POSTS_MIN_TIMEOUT_MS env
Lowest timeout a posts call may request, in milliseconds.
POSTS_MAX_TIMEOUT_MS env
Highest timeout a posts call may request, in milliseconds.
USERS_MAX_USERNAMES env
Usernames accepted in one x_users_lookup call. The X API caps this at 100.
USERS_MAX_IDS env
User ids accepted in one x_users_lookup call. The X API caps this at 100.
USERS_DEFAULT_RESULTS env
Users returned per page when the call does not ask for a count.
USERS_MAX_RESULTS env
Upper bound for users per page.
USERS_DEFAULT_TIMEOUT_MS env
Timeout for a users call in milliseconds when the call does not request one.
USERS_MIN_TIMEOUT_MS env
Lowest timeout a users call may request, in milliseconds.
USERS_MAX_TIMEOUT_MS env
Highest timeout a users call may request, in milliseconds.
LISTS_DEFAULT_RESULTS env
Items returned per list page when the call does not ask for a count.
LISTS_MAX_RESULTS env
Upper bound for items per list page. The X API caps this at 100.
LISTS_DEFAULT_TIMEOUT_MS env
Timeout for a lists call in milliseconds when the call does not request one.
LISTS_MIN_TIMEOUT_MS env
Lowest timeout a lists call may request, in milliseconds.
LISTS_MAX_TIMEOUT_MS env
Highest timeout a lists call may request, in milliseconds.
MEDIA_CHUNK_BYTES env
Bytes per upload segment. The X APPEND endpoint caps a segment at 5 MB.
MEDIA_POLL_INTERVAL_MS env
How often the upload status is polled while X transcodes a video, in milliseconds.
MEDIA_DEFAULT_TIMEOUT_MS env
Timeout for a whole upload in milliseconds when the call does not request one.
MEDIA_MIN_TIMEOUT_MS env
Lowest timeout an upload may request, in milliseconds.
MEDIA_MAX_TIMEOUT_MS env
Highest timeout an upload may request, in milliseconds.

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同，请以 README 为准。

它能做什么

它在你的电脑上运行；安装后，工具列表会显示在你的 AI 应用中。

基础检查i

我们检查的是任何人都能看到的信息；我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月7日

✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 Role1776 验证，该账户拥有此仓库
… 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
… 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
– 不适用
端点有响应
它在你的电脑上运行，没有互联网端点
– 不适用
使用 OAuth 登录
在你的电脑上运行，改用本地设置
… 尚未检查
工具描述中没有隐藏指令
它在你的电脑上运行；我们只能读取互联网端点的工具列表

与“营销与社交媒体”中的其他服务器比较i

星标数多于此分类中其他 3566 个服务器的 0%
发布到注册中心的时间比此分类中其他 3566 个服务器的 32% 更新
基础检查结果等于或优于此分类中其他 3566 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时，星标数才计入。

常见问题

X (Twitter) 安全吗？

它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前，请先看看这个服务器要求哪些权限，并使用只具备所需权限的密钥。

它需要哪些密钥或代码？

你需要填写：X_API_KEY, X_API_KEY_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET, MEDIA_ROOT

它在我的电脑上运行还是在云端？

它在你的电脑上运行。你的 AI 应用会在需要时启动它，数据不会经过作者的服务器（除非它自己调用在线服务）。

它还在维护吗？

GitHub 仓库最后更新于–，最新版本（0.1.1）于2个月前进入注册中心。

哪些应用可以使用它？

支持 MCP 的应用，例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Docker, MCPB。

有什么可以替代它？

同一分类中有：MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer

替代选择

同一分类中其他作者的服务器，按星标数排序。

如何看卡片：★ GitHub 星标i三大支柱：评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

MCP YouTube Transcript

作者：jkawamoto

An MCP server retrieving transcripts of YouTube videos

在你的电脑上运行★ 495MIT10天前更新

安装

Google Analytics MCP

作者：surendranb

GA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.

在你的电脑上运行★ 244MIT10天前更新

安装

BibiGPT YouTube Video Summarizer

作者：JimmyLv

AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.

在云端运行★ 137MIT11天前更新

安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

mcp-x

An MCP server that gives an LLM the X (Twitter) API: read and search posts, manage users and lists, upload media, and publish — as the account whose keys it runs on.

Website · Costs · Credentials · Tools · Quick start · Configuration · Architecture · Contributing

What it is

mcp-x is a Model Context Protocol server written in Go. It exposes the X API v2 to any MCP-compatible client (Claude Desktop, IDE agents, custom LLM apps) as 42 tools covering posts, users, lists and media.

It authenticates with OAuth 1.0a user context, which means every call acts *as a real X account* — the one the four keys belong to. x_post_create publishes publicly. x_user_follow really follows. x_post_delete is irreversible. This is not a sandbox, and it is not free: see The X API costs money before you wire it into an agent.

Both transports the MCP SDK supports are available and expose the identical tool set:

stdio — the client launches the binary and talks over stdin/stdout (the default, ideal for desktop clients).
http — a long-running streamable HTTP server (useful for remote/shared deployments).

The X API costs money

[!WARNING]

There is no free tier any more. X retired the Free/Basic/Pro subscription tiers for new developers and moved to pay-per-use credits: you buy credits upfront in the Developer Console and every request deducts from the balance in real time. Legacy Basic ($200/mo) and Pro ($5,000/mo) subscriptions survive only for accounts that already had them; Enterprise starts around $42,000/mo. A new developer account today gets pay-per-use and nothing else.

Rates at the time of writing (official pricing — always re-check the Console, they have changed several times in 2026):

Operation	Price
Post read	$0.005 per post returned
Owned read (your own posts, bookmarks, followers, likes, lists)	$0.001 per resource
User read	$0.010 per user returned
Likes / mutes / blocks read	$0.001 per resource
Followers / following read	$0.010 per resource
Publishing a post	$0.015 per request
Publishing a post containing a URL	$0.200 per request
Like / repost and other interactions	$0.015 per request
List and bookmark writes	$0.005–$0.010 per request

Two things follow from this, and both are baked into the server:

**Reads are charged per *resource returned*, not per request.** max_results: 100 on x_posts_search costs twenty times what max_results: 5 costs for the same query. Every read tool's description tells the model to ask for the smallest max_results that answers the question, and the batching tools (x_posts_lookup, x_users_lookup) tell it to batch rather than loop.
`x_posts_count` does not consume the post-read budget. It returns match counts bucketed by minute/hour/day for the same query syntax. Size a topic with x_posts_count first, then pay for x_posts_search.

X also deduplicates: the same resource fetched twice inside a 24-hour UTC window is billed once. And pay-per-use is capped at 3 million post reads per billing cycle — past that, only Enterprise.

When the money runs out the API answers with a distinct error, and the server maps it to a message that explicitly tells the model not to retry — see Errors.

Credentials

The server needs four OAuth 1.0a values, all from one X app:

X_API_KEY

X_API_KEY_SECRET X_ACCESS_TOKEN X_ACCESS_TOKEN_SECRET

The first pair identifies the *app*; the second pair identifies the *account acting through it*. mcp-x uses AuthenMethodOAuth1UserContext, not app-only bearer auth, because every write endpoint and every "me" endpoint (x_users_me, x_posts_home, x_bookmarks_list, mentions) requires a user context. There is no bearer-token mode.

Getting them — and the one step everybody gets wrong

Go to developer.x.com → your project → your app.
Open User authentication settings and set App permissions to Read and Write. Do this first.
*Only then* go to Keys and tokens and generate the Access Token and Secret.

[!IMPORTANT]

An access token permanently keeps the permissions the app had at the moment it was generated. If you created the token while the app was Read-only and then flipped the app to Read and Write, the token is *still* read-only. Nothing about the app settings page will tell you this. Every write will fail with X's oauth1-permissions problem type, forever, until you go back to Keys and tokens and regenerate the Access Token and Secret.

This is the single most common setup failure with the X API, which is why the server checks for it at startup and refuses to start with:

`

the access token is read-only: set the app permissions to Read and Write

in the X Developer Console, then regenerate the Access Token and Secret

`

Regenerating the *API Key/Secret* is not the fix. Regenerate the Access Token and Secret.

Startup verification

Before registering a single tool, the server calls GET /2/users/me once (client.Bootstrap) with a 15-second deadline. This does three jobs:

proves the four keys are valid — bad keys fail the process, not the first tool call;
catches the read-only-token trap above;
caches the key owner's numeric user id, because every write endpoint is POST /2/users/:id/... and looking the id up per write would be another billed request.

A failure here is fatal by design. A server that starts and then fails every call is worse than one that does not start.

The cost of that choice is worth stating plainly: there is no way to try this server without a funded X developer account. No credentials means no startup, which means no tool list — /mcp and claude mcp list will show a failed connection and nothing else. To confirm an install short of that, run the binary with -version, and read the Tools section for what it would have exposed.

Keys are secrets

The four values are credentials for a live account with write access. Keep them in a file only you can read, pass it with -env, and never commit it — .env is gitignored, .env.example is the template. When running under an MCP client, the client's env block works too; it takes precedence over the .env file.

Tools

42 tools in four groups. Every tool carries MCP annotations: readOnlyHint on reads, destructiveHint on anything irreversible (x_post_delete, x_list_delete, unlike, unrepost, unfollow, member removal). Each returns a structured JSON payload matching its output schema; the SDK mirrors the same JSON into the text content block for clients that do not read structuredContent.

Every tool accepts an optional timeout_ms, clamped into the group's [MIN, MAX] window (see Limits).

Posts — reading

Tool	Description
`x_posts_search`	Searches recent posts for several queries in parallel. Recent search reaches back 7 days only.
`x_posts_count`	Counts matches per query bucketed by minute/hour/day. Does not spend post reads — use it to size a topic before searching.
`x_posts_lookup`	Fetches up to 100 posts by id in one call.
`x_posts_by_user`	Recent posts for several usernames, fetched in parallel.
`x_posts_mentions`	Posts mentioning the key owner.
`x_posts_home`	The key owner's home timeline.
`x_posts_quotes`	Posts quoting a given post.
`x_posts_liked`	Posts the key owner liked.
`x_bookmarks_list`	The key owner's bookmarks.
`x_post_liked_by`	Users who liked a given post.
`x_post_reposted_by`	Users who reposted a given post.

`x_posts_search`

Parameter	Type	Default	Notes
`queries`	`[]string`	—	Required. Run in parallel, capped at `POSTS_MAX_QUERIES` (`5`). ≤ 512 chars each.
`max_results`	`int`	`10`	Posts per query, 1..100. Every one is billed.
`sort_order`	`string`	—	`recency` (newest first) or `relevancy` (best match).
`days`	`int`	`7`	How far back, 1..7. The API cannot go further.
`include_retweets`	`bool`	`false`	When false the server appends `-is:retweet` to every query.
`timeout_ms`	`int64`	`15000`	Whole-call timeout, clamped to `[2000, 60000]`.

Query operators go inside the query string:

Operator	Meaning
space	AND
`OR`	explicit OR
`-term`	NOT
`( )`	grouping
`from:user` / `to:user`	by author / by recipient
`@user` / `#tag`	mentions / hashtags
`"exact phrase"`	exact phrase
`lang:en`	language
`is:retweet` `is:reply` `is:quote` `is:verified`	post kind
`has:media` `has:images` `has:videos` `has:links`	attachments
`url:example.com`	linked domain
`conversation_id:123`	one thread

`x_posts_count`

Parameter	Type	Default	Notes
`queries`	`[]string`	—	Required. Same operators as `x_posts_search`.
`granularity`	`string`	`hour`	`minute`, `hour` or `day`.
`days`	`int`	`7`	1..7, same window.
`timeout_ms`	`int64`	`15000`	Clamped to `[2000, 60000]`.

`x_posts_lookup`

Parameter	Type	Default	Notes
`ids`	`[]string`	—	Required. 1..100 post ids. Batch them; do not call once per id.

`x_posts_by_user`

Parameter	Type	Default	Notes
`usernames`	`[]string`	—	Required. Without the `@`. Capped at `POSTS_MAX_USERNAMES` (`5`), fetched in parallel.
`max_results`	`int`	`10`	Posts per user, 1..100.
`exclude`	`[]string`	—	`replies` and/or `retweets`.
`days`	`int`	`7`	1..7.
`timeout_ms`	`int64`	`15000`	Clamped to `[2000, 60000]`.

Timeline tools

x_posts_mentions, x_posts_home, x_posts_liked and x_bookmarks_list share one shape: max_results (1..100), pagination_token, timeout_ms. x_posts_quotes, x_post_liked_by and x_post_reposted_by add a required id.

Pagination is explicit and manual: a response carries next_token, and you pass it back as pagination_token for the next page. The server never walks pages on its own — each page is billed, so that decision stays with the caller.

Posts — writing

Tool	Annotation	Description
`x_post_create`	write	Publishes a post. Public and billed ($0.015, or $0.20 with a link).

| `x_post_delete` | de

只显示了开头部分；其余内容请在仓库中阅读