Rednote Mind MCP

Rednote-Mind-Skills

让 AI 成为你的知识管理助手：本地代码库 + 社交媒体热点追踪

这是什么？

Rednote-Mind-Skills 是一套 Claude Code Skills + MCP 工具的组合，帮助你：

架构

┌─────────────────────────────────────────────────────────┐
│                    Claude Code                          │
├─────────────────────────────────────────────────────────┤
│  /github-kb skill                                       │
│  ├── search     → 搜索本地知识库                         │
│  ├── update     → 同步仓库索引                           │
│  ├── discover   → 多源发现新仓库                         │
│  ├── xiaohongshu → 小红书搜索                            │
│  └── twitter    → 推文抓取                               │
├─────────────────────────────────────────────────────────┤
│  MCP 工具层                                              │
│  ├── rednote-mind-mcp  → 小红书 7 个工具                 │
│  ├── tavily            → Web 搜索                       │
│  └── gh CLI            → GitHub 操作                    │
└─────────────────────────────────────────────────────────┘

快速开始 (5 分钟)

1. 安装 MCP 工具

# 安装小红书 MCP
npm install -g rednote-mind-mcp

# 首次登录小红书（扫码）
rednote-init

2. 配置 MCP 服务器

编辑 ~/.claude.json（或 Claude Desktop 配置）:

{
  "mcpServers": {
    "rednote": {
      "command": "npx",
      "args": ["-y", "rednote-mind-mcp"]
    },
    "tavily": {
      "command": "npx",
      "args": ["-y", "@tavily/mcp"],
      "env": {
        "TAVILY_API_KEY": "your_key"
      }
    }
  }
}

3. 安装 Skill

# 克隆仓库
git clone https://github.com/CopeeeTang/rednote-mind-skills.git

# 复制 skill 到 Claude Code skills 目录
cp -r rednote-mind-skills/skills/github-kb ~/.claude/skills/

4. 设置环境变量

# 添加到 ~/.zshrc 或 ~/.bashrc
export JINA_API_KEY="your_jina_key"          # Twitter 抓取（必需）
export ZZZ_API_KEY="your_zzz_key"            # VLM 图片分析（可选，推荐）
export ZHIPU_API_KEY="your_zhipu_key"        # VLM 备选（有内置测试 Key）

5. 初始化知识库

mkdir -p ~/github

Skill 使用指南

/github-kb search

搜索本地知识库中的仓库。

/github-kb search MCP
→ 匹配: mcp-servers, rednote-mind-mcp
→ 是否查看详情？

/github-kb update

同步本地仓库到索引。

/github-kb update
→ 扫描 ~/github 下 15 个仓库
→ 新增: 2, 更新: 1, 删除: 0
→ 确认更新索引？

/github-kb discover

多源发现并 clone 新仓库。

/github-kb discover Claude MCP tools
→ 搜索小红书、Twitter、Tavily...
→ 发现 5 个相关仓库:
  1. anthropics/claude-code (⭐ 12.3k)
  2. modelcontextprotocol/servers (⭐ 8.1k)
  ...
→ 选择要 clone 的仓库

/github-kb xiaohongshu

直接搜索小红书笔记。

/github-kb xiaohongshu Python 数据分析
→ 找到 10 条笔记
→ 是否分析收藏夹中的相关内容？

/github-kb twitter

抓取推文内容。

/github-kb twitter https://x.com/karpathy/status/123456
→ [Andrej Karpathy]
→ This is the tweet content...

DeepWiki 模式

AI 主动查询本地知识库：当你问技术问题时，AI 会先检查本地仓库是否有答案。

你: 如何在 Python 中使用 MCP 工具？

AI: [检查本地知识库...]
    找到相关仓库: ~/github/mcp-python-sdk
    [读取 README.md 和 examples/]

    根据你本地的 mcp-python-sdk 仓库，使用方法如下：

    from mcp import Client
    client = Client()
    ...

触发条件：

• "How does X work?"
• "Show me an example of X"
• "What's the best practice for X?"

MCP 工具详情

小红书 MCP (rednote-mind-mcp)

7 个工具，完整文档见

图片处理模式

VLM 提供商优先级

1. 智增增 (ZZZ_API_KEY) - 推荐，成本低
2. Jina (JINA_API_KEY) - 备选
3. 智谱 GLM-4V (ZHIPU_API_KEY) - 有内置测试 Key

Twitter/X 抓取

使用 Jina.ai Reader API，需要 JINA_API_KEY。

免费获取：https://jina.ai/

使用示例

示例 1：整理收藏夹中的 AI 论文

请分析我小红书收藏夹中最近 15 篇 AI 论文笔记，
提取论文标题、核心观点、关键图表，生成表格。

示例 2：发现热门开源项目

/github-kb discover LLM fine-tuning
→ 搜索多个来源...
→ 推荐仓库列表
→ Clone 到本地知识库

示例 3：技术问题查询

你: 如何配置 MCP 服务器？

AI: [检查本地知识库]
    找到: ~/github/modelcontextprotocol-servers
    根据本地文档，配置方法如下...

示例 4：VLM 分析图片

获取笔记 https://www.xiaohongshu.com/explore/xxx?xsec_token=...，
使用 VLM 模式分析图片中的文字和公式。

配置参考

环境变量

数据存储

自定义知识库路径

在项目的 CLAUDE.md 中添加：

KB_PATH: /your/custom/path

故障排除

小红书登录过期

rm ~/.mcp/rednote/cookies.json
rednote-init

Twitter 抓取失败

# 检查 API Key
echo $JINA_API_KEY

# 测试 API
curl -s "https://r.jina.ai/https://x.com" -H "Authorization: Bearer $JINA_API_KEY" | head -20

VLM 分析不工作

• 检查 ZZZ_API_KEY 或 ZHIPU_API_KEY 是否设置
• 智谱有内置测试 Key，应该开箱即用

Skill 未加载

# 确认 skill 目录存在
ls ~/.claude/skills/github-kb/

# 检查 SKILL.md 格式
cat ~/.claude/skills/github-kb/SKILL.md

项目结构

rednote-mind-skills/
├── README.md                    # 本文件
├── skills/
│   └── github-kb/               # Claude Code Skill
│       ├── SKILL.md             # Skill 定义
│       ├── references/
│       │   ├── xiaohongshu.md   # 小红书工具文档
│       │   ├── twitter.md       # Twitter 工具文档
│       │   └── setup.md         # 配置指南
│       └── scripts/
│           ├── fetch_tweet.py   # 推文抓取脚本
│           └── fetch_tweets.sh  # 批量抓取脚本
├── src/                         # MCP 服务器源码
├── package.json                 # npm 包 (rednote-mind-mcp)
└── ...

贡献

欢迎提交 Issue 和 Pull Request！

License

MIT License - 详见 LICENSE

GitHub:

npm: rednote-mind-mcp

立即开始：

npm install -g rednote-mind-mcp && rednote-init