Skip to main content
Glama
ethancod1ng

RedNote MCP Server

by ethancod1ng

RedNote MCP Server

一个基于 Model Context Protocol (MCP) 的小红书平台集成服务器,为 AI 助手提供访问小红书内容和功能的能力。

功能特性

  • 🔍 内容搜索: 支持关键词搜索小红书笔记

  • 📝 笔记获取: 获取笔记详情和用户内容

  • 👥 用户信息: 查询用户资料和统计数据

  • 📈 趋势分析: 获取热门话题和内容趋势

  • 🤖 内容分析: 提供情感分析、关键词提取等功能

Related MCP server: File MCP Server

快速开始

安装依赖

npm install

构建项目

npm run build

启动服务器

npm start

开发模式

npm run dev

可用工具

搜索工具

rednote_search_notes

搜索小红书笔记

参数:

  • keyword (required): 搜索关键词

  • type (optional): 内容类型 (note, video, all)

  • sort (optional): 排序方式 (latest, popular, relevant)

  • limit (optional): 返回数量限制 (1-100)

示例:

{
  "keyword": "美食",
  "type": "note",
  "sort": "popular",
  "limit": 20
}

内容工具

rednote_get_note

获取笔记详情

参数:

  • note_id (required): 笔记ID

  • include_comments (optional): 是否包含评论

rednote_get_user_notes

获取用户笔记

参数:

  • user_id (required): 用户ID

  • limit (optional): 数量限制

  • cursor (optional): 分页游标

获取热门话题

参数:

  • category (optional): 分类

  • limit (optional): 数量限制

用户工具

rednote_get_user_info

获取用户信息

参数:

  • user_id (required): 用户ID或用户名

分析工具

rednote_analyze_content

分析内容

参数:

  • content (required): 内容文本

  • analysis_type (optional): 分析类型 (sentiment, keywords, category, all)

配置

配置文件位于 config/ 目录下,支持不同环境的配置:

  • default.json: 默认配置

  • production.json: 生产环境配置

  • development.json: 开发环境配置

主要配置项

{
  "api": {
    "timeout": 15000,
    "retries": 3,
    "retryDelay": 2000
  },
  "cache": {
    "enabled": true,
    "ttl": 300000,
    "maxSize": 1000
  },
  "logging": {
    "level": "info"
  }
}

MCP 集成

在 Claude Desktop 中使用

  1. 构建项目:

    npm run build
  2. 在 Claude Desktop 配置文件中添加:

    {
      "mcpServers": {
        "rednote": {
          "command": "node",
          "args": ["/path/to/rednote-mcp-server/dist/index.js"]
        }
      }
    }

使用其他 MCP 客户端

服务器实现了标准的 MCP 协议,可以与任何兼容的 MCP 客户端集成。

开发

项目结构

src/
├── index.ts              # 入口文件
├── server.ts             # MCP 服务器实现
├── tools/                # MCP 工具定义
│   ├── search.ts         # 搜索相关工具
│   ├── content.ts        # 内容获取工具
│   ├── user.ts           # 用户信息工具
│   └── analysis.ts       # 分析工具
├── api/                  # API 客户端
│   ├── client.ts         # HTTP 客户端
│   └── rednote.ts        # 小红书 API 封装
├── utils/                # 工具函数
│   ├── cache.ts          # 缓存管理
│   ├── logger.ts         # 日志工具
│   └── validators.ts     # 参数验证
└── types/                # 类型定义
    ├── api.ts            # API 响应类型
    ├── mcp.ts            # MCP 相关类型
    └── rednote.ts        # 小红书数据类型

代码质量

# 类型检查
npm run typecheck

# 代码检查
npm run lint

# 运行测试
npm test

注意事项

  1. API 限制: 当前实现使用模拟数据,实际使用时需要集成真实的小红书 API

  2. 速率限制: 请注意 API 调用频率限制,避免被平台限制

  3. 数据合规: 确保数据获取和使用符合相关法律法规

  4. 缓存策略: 合理使用缓存以提高性能和减少 API 调用

许可证

MIT License

贡献

欢迎提交 Issues 和 Pull Requests!

Available Tools

6 tools
rednote_analyze_contentD

分析内容

ParametersJSON Schema
NameRequiredDescriptionDefault
contentYes内容文本
analysis_typeNo分析类型all

TDQS

D1.7/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. The description '分析内容' gives no indication of whether this is a read-only operation, if it has side effects, what permissions might be required, rate limits, or what the output format might be. For an analysis tool with zero annotation coverage, this is completely inadequate.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

While technically concise with just two characters, this represents under-specification rather than effective conciseness. The description fails to provide any meaningful information that would help an AI agent understand or use the tool correctly. Every sentence should earn its place, and this description doesn't earn its place at all.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has 2 parameters, no annotations, and no output schema, the description '分析内容' is completely inadequate. It doesn't explain what analysis is performed, what the output looks like, when to use it, or any behavioral characteristics. For an analysis tool with this level of complexity and no structured support, the description fails to provide necessary context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, with both parameters ('content' and 'analysis_type') having descriptions in the schema. The tool description adds no additional meaning about parameters beyond what's already documented in the schema. According to the rules, when schema coverage is high (>80%), the baseline score is 3 even with no parameter information in the description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description '分析内容' (analyze content) is a tautology that essentially restates the tool name 'rednote_analyze_content' in Chinese. It doesn't specify what kind of analysis is performed, what resources are involved, or how it differs from sibling tools like 'rednote_search_notes' or 'rednote_get_trending_topics'. The purpose remains vague without additional context.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is absolutely no guidance on when to use this tool versus alternatives. The description provides no context about appropriate use cases, prerequisites, or distinctions from sibling tools that also deal with content (like search_notes or get_trending_topics). This leaves the agent with no directional information.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

rednote_get_noteC

获取笔记详情

ParametersJSON Schema
NameRequiredDescriptionDefault
note_idYes笔记ID
include_commentsNo是否包含评论

TDQS

C2.7/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. '获取笔记详情' implies a read-only operation, but it doesn't specify authentication requirements, rate limits, error conditions, or what '详情' (details) encompasses. For a tool with zero annotation coverage, this leaves significant gaps in understanding how the tool behaves beyond its basic function.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise—a single phrase ('获取笔记详情') that directly states the tool's purpose. There is zero wasted language, and it's front-loaded with the essential action. Every word earns its place, making it efficient for quick comprehension.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the lack of annotations and output schema, the description is incomplete for effective tool use. It doesn't explain what '详情' includes (e.g., note content, metadata, attachments), how errors are handled, or what the return format looks like. For a retrieval tool with no structured output documentation, the description should provide more context about the expected behavior and results.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description adds no parameter-specific information beyond what the schema already provides (100% coverage). The schema fully documents both parameters: 'note_id' as the required note identifier and 'include_comments' as an optional boolean flag. Since the schema does all the heavy lifting, the baseline score of 3 is appropriate—the description doesn't compensate but doesn't need to given complete schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description '获取笔记详情' (Get note details) states a clear verb ('获取' - get) and resource ('笔记详情' - note details), establishing the basic purpose. However, it doesn't differentiate this tool from its sibling 'rednote_get_user_notes' (which likely lists multiple notes) or 'rednote_search_notes' (which searches notes), leaving the scope vague. The description is functional but lacks specificity about what distinguishes this single-note retrieval from other note-related operations.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention that this is for retrieving a specific note by ID (as opposed to 'rednote_get_user_notes' for listing notes or 'rednote_search_notes' for searching). There are no explicit when/when-not instructions, prerequisites, or named alternatives. The agent must infer usage from the parameter names alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

rednote_get_user_infoC

获取用户信息

ParametersJSON Schema
NameRequiredDescriptionDefault
user_idYes用户ID或用户名

TDQS

C2.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure but provides minimal information. '获取用户信息' implies a read operation but doesn't specify what kind of information is returned, whether authentication is required, if there are rate limits, or what format the response takes. For a tool with zero annotation coverage, this leaves significant behavioral questions unanswered.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise at just three Chinese characters ('获取用户信息'), which translates to 'Get user information'. There is zero wasted language or unnecessary elaboration. While this conciseness comes at the cost of detail, the description is perfectly front-loaded and every character serves its purpose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given that this is a user information retrieval tool with no annotations, no output schema, and a minimal description, the contextual information is inadequate. The description doesn't explain what kind of user information is returned, how it differs from sibling tools, or what the response format looks like. For a tool that presumably returns structured user data, more context would be helpful for an AI agent to understand when and how to use it effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% description coverage, with the single parameter 'user_id' clearly documented as accepting either user ID or username. The description adds no additional parameter information beyond what the schema provides. According to scoring rules, when schema_description_coverage is high (>80%), the baseline is 3 even with no parameter information in the description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description '获取用户信息' (Get user information) is a tautology that essentially restates the tool name 'rednote_get_user_info'. It provides a generic verb+resource but lacks specificity about what type of user information is retrieved or how it differs from sibling tools like 'rednote_get_user_notes' which also deals with user data. The purpose is clear at a basic level but doesn't distinguish this tool from alternatives.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. There are multiple sibling tools dealing with user data (rednote_get_user_notes) and note retrieval (rednote_get_note, rednote_search_notes), but the description offers no context about when this specific user information tool is appropriate versus those other options. No prerequisites, exclusions, or alternative suggestions are mentioned.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

rednote_get_user_notesC

获取用户笔记

ParametersJSON Schema
NameRequiredDescriptionDefault
user_idYes用户ID
limitNo数量限制
cursorNo分页游标

TDQS

C2.7/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It implies a read operation ('获取' - get) but doesn't specify if it's safe (non-destructive), requires authentication, has rate limits, returns paginated results (suggested by the 'cursor' parameter), or what the output format is. For a tool with parameters and no annotations, this leaves significant gaps in understanding its behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise with a single phrase ('获取用户笔记'), which is front-loaded and wastes no words. For a simple retrieval tool, this brevity is appropriate, though it may sacrifice clarity. Every part of the description directly states the purpose without redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has 3 parameters, no annotations, and no output schema, the description is incomplete. It doesn't address behavioral aspects (e.g., pagination, safety), usage context, or output details, leaving the agent with insufficient information to invoke it effectively. The high schema coverage helps, but overall context is lacking for a tool with multiple parameters and siblings.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description coverage is 100%, with clear descriptions for all parameters (user_id, limit, cursor). The description adds no additional meaning beyond the schema, such as explaining how 'cursor' enables pagination or typical use cases for 'limit'. Since the schema does the heavy lifting, the baseline score of 3 is appropriate, but no extra value is provided.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description '获取用户笔记' (Get user notes) states a clear verb ('获取' - get/retrieve) and resource ('用户笔记' - user notes), providing a basic purpose. However, it lacks specificity about what kind of notes or how they're retrieved, and doesn't distinguish from sibling tools like 'rednote_get_note' (likely for a single note) or 'rednote_search_notes' (likely for broader searches). It's adequate but vague.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention prerequisites (e.g., needing a valid user_id), exclusions, or comparisons to siblings like 'rednote_get_note' (for single notes) or 'rednote_search_notes' (for filtered searches). Without such context, an agent might struggle to choose correctly among similar tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

rednote_search_notesC

搜索小红书笔记

ParametersJSON Schema
NameRequiredDescriptionDefault
keywordYes搜索关键词
typeNo内容类型all
sortNo排序方式relevant
limitNo返回数量限制

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure but only states the basic action. It doesn't mention whether this is a read-only operation, potential rate limits, authentication requirements, pagination behavior, or what format/search scope the results cover. '搜索' implies querying, but no further behavioral context is provided.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is maximally concise with a single 4-character phrase that directly conveys the core function. There's zero wasted language or unnecessary elaboration, making it highly efficient for an agent to parse.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a search tool with 4 parameters, no annotations, and no output schema, the description is insufficiently complete. It doesn't explain what kind of results to expect, how results are structured, whether there are limitations on search scope, or how this differs from other note-retrieval tools. The agent would need to guess about important behavioral aspects.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 100% schema description coverage, the schema already documents all 4 parameters thoroughly with descriptions, defaults, enums, and constraints. The description adds no additional parameter semantics beyond what's in the schema, so it meets the baseline for high schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description '搜索小红书笔记' clearly states the action (搜索/search) and resource (小红书笔记/Xiaohongshu notes), making the purpose immediately understandable. However, it doesn't differentiate this search tool from sibling tools like rednote_get_note or rednote_get_user_notes, which also retrieve note-related content.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. There's no mention of when this search function is appropriate compared to rednote_get_note (for specific notes), rednote_get_user_notes (for user-specific notes), or rednote_get_trending_topics (for trending content).

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 6 tool updates
    • First observedrednote_analyze_content
    • First observedrednote_get_note
    • First observedrednote_get_trending_topics
    • First observedrednote_get_user_info
    • First observedrednote_get_user_notes
    • First observedrednote_search_notes

TDQS

C2.8/5.0
Disambiguation4/5

Most tools have distinct purposes targeting different resources (content analysis, note details, trending topics, user info, user notes, note search). However, 'rednote_get_note' and 'rednote_get_user_notes' could potentially overlap if a user's notes are accessed individually versus collectively, but the descriptions clarify this as separate operations.

Naming Consistency5/5

All tools follow a consistent 'rednote_verb_noun' pattern with clear, descriptive names. The verb-noun structure is uniform across all six tools, making them predictable and easy to understand.

Tool Count5/5

With 6 tools, the count is well-scoped for a RedNote (Xiaohongshu) server. It covers key operations like content analysis, note retrieval, user info, and search without being overwhelming or too sparse.

Completeness3/5

The tools provide good read/search capabilities for notes, users, and trends, but there are notable gaps in write operations (e.g., creating, updating, or deleting notes or user interactions). This limits the server to observational tasks, missing full lifecycle coverage for the social media domain.

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    A
    maintenance
    A Model Context Protocol (MCP) server for the Open Library API that enables AI assistants to search for book information.
    10
    7
    326
    91
    MIT
  • F
    license
    A
    quality
    D
    maintenance
    A Model Context Protocol (MCP) server that enables AI assistants to perform comprehensive file operations including finding, reading, writing, editing, searching, moving, and copying files with security validations.
    7
    1
    -
  • A
    license
    A
    quality
    D
    maintenance
    A Model Context Protocol server that enables AI assistants to make HTTP requests (GET, POST, PUT, DELETE) to external APIs through standardized MCP tools.
    4
    2
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ethancod1ng/rednote-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server