AIニケちゃん知识检索 MCP 服务器

非官方工具。 本项目未经 AIニケちゃん、其运营者、X、OpenAI 或相关各公司、团体的批准、合作或赞助。名称、帖子、网站等信息来源的相关权利归各权利所有者所有。

这是用于从 MCP（Model Context Protocol）客户端搜索 AIニケちゃん相关公开信息的 Next.js / Vercel 服务器。问题经由 Vercel AI Gateway 通过 OpenAI Embeddings 进行向量化，搜索结果中包含信息来源 URL 和发帖日期时间。

不应包含在公开仓库中的内容

本仓库绝不提交以下内容。

• X 帖子的采集数据及其派生文本

• 包含帖子正文的搜索元数据和已生成的向量

• .env 系列环境变量文件、API 密钥、认证令牌

这些内容已通过 .gitignore 和 .vercelignore 排除。在公开部署中，已生成的索引从 Private Vercel Blob 读取，因此帖子数据不会包含在仓库或 Function 的分发物中。

演示公开与安全性

本项目面向短期公开演示，将 MCP 端点以无认证方式公开。在 Vercel 中注册 AI_GATEWAY_API_KEY，以及连接 Private Blob 后新增的存储设置。请勿将值保存到 GitHub、客户端代码或日志中。

AI_GATEWAY_API_KEY=
BLOB_READ_WRITE_TOKEN=

由于第三方也可以执行搜索，因此会产生 AI Gateway 的使用费用。请缩短公开期间，在设置 Vercel 侧的 WAF 和速率限制后，确认使用情况。演示结束后请停止部署。

在此工作文件夹的 .env 中检测到了疑似认证信息的值。在添加到 Git 之前，请确认当前是否未在使用，如有必要请轮换密钥。

本地开发

npm install
cp .env.example .env.local
# .env.local に OPENAI_API_KEY を設定
npm run build:index
npm run dev

本地搜索端点为 http://localhost:3000/api/mcp。要生成索引，需要在本地拥有被排除的 X 帖子数据。

向 Vercel Blob 部署索引

1. 从 Vercel 项目的 Storage 中创建 Private 访问的 Blob 存储，并连接到项目。

2. 将 Vercel 的环境变量获取到本地，并在本地 .env.local 中设置 BLOB_READ_WRITE_TOKEN。

3. 在本地生成索引后，执行以下命令。

npm run upload:index

indexes/metadata.json 和 indexes/embeddings.f32 将上传到 Private Blob。在 Vercel 环境中读取这两者，在本地环境中则照旧读取 src/data 中的文件。仅在需要更改 Blob 内路径时，请将 VECTOR_INDEX_METADATA_PATH 和 VECTOR_INDEX_VECTORS_PATH 在本地与 Vercel 两侧设置为相同的值。

MCP 工具

• search_nikechan_knowledge：跨 X 帖子和官方网站的语义搜索

• search_x_posts：仅针对 X 帖子的语义搜索

• search_hybrid：结合关键词匹配与语义搜索的搜索

• search_keywords：关键词搜索

• search_timeline：按期间、年月搜索

• get_popular_posts：按互动数排序的搜索

• get_x_post / get_x_thread：获取帖子或帖子串

• x_posts_dataset_info：确认索引的条数与构成

结果是基于公开信息的参考信息。由于不保证准确性、完整性和时效性，请在回答时核对返回的 URL 的原始出处。

验证

npm run lint
npm test
npm run build

已知的部署前确认事项

依赖关系审计中仍存在 Next.js 系列的高严重性漏洞。由于修复涉及升级到 Next.js 16 的破坏性变更，因此本仓库未进行自动更新。在 Vercel 正式发布之前，请在确认兼容性后更新 Next.js，并再次执行 npm audit --omit=dev --audit-level=high。