From fe7ea21a3fe934af9d9e39e2ec9a2390a015fd9f Mon Sep 17 00:00:00 2001 From: zy Date: Tue, 17 Feb 2026 23:00:16 +0800 Subject: [PATCH] Update English README to match Chinese version (#427) - Update contributors badge count from 17 to 22 - Update inspector config image to use GitHub assets URL - Add note about checking sidebar options in MCP inspector - Add `claude mcp list` command in Claude Code CLI sections - Add complete FAQ section (Section 2.5) - Update WeChat group number from 10 to 14 with new QR code - Add 5 missing contributors: flippancy, Infinityay, Bryan Thompson, tan jun, coldmountain - Update Special Thanks section to include tanxxjun321 and Angiin Co-authored-by: Claude --- README_EN.md | 76 +++++++++++++++++++++++++++++++++++++++++++++------- 1 file changed, 67 insertions(+), 9 deletions(-) diff --git a/README_EN.md b/README_EN.md index 0aa7e70..8127987 100644 --- a/README_EN.md +++ b/README_EN.md @@ -1,7 +1,7 @@ # xiaohongshu-mcp -[![All Contributors](https://img.shields.io/badge/all_contributors-17-orange.svg?style=flat-square)](#contributors-) +[![All Contributors](https://img.shields.io/badge/all_contributors-22-orange.svg?style=flat-square)](#contributors-) [![Philanthropy](https://img.shields.io/badge/Philanthropy-CNY%201300.00-brightgreen?style=flat-square)](./DONATIONS.md) @@ -412,7 +412,9 @@ npx @modelcontextprotocol/inspector After running, open the red-marked link, configure MCP inspector, enter `http://localhost:18060/mcp`, and click the `Connect` button. -![Configure MCP inspector](./assets/inspect_mcp.png) +bf9532dd0b7ba423491accf511a467de + +**Note:** Check if the options in the left sidebar are correct. After configuring MCP inspector as above, click the `List Tools` button to view all Tools. @@ -466,6 +468,9 @@ curl -X POST http://localhost:18060/mcp \ ```bash # Add HTTP MCP server claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp + +# Check if MCP was added successfully (ensure MCP is already started before running this command) +claude mcp list ``` ### 2.2. Supported Clients @@ -478,6 +483,9 @@ Official command line tool, already shown in the quick start section above: ```bash # Add HTTP MCP server claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp + +# Check if MCP was added successfully (ensure MCP is already started before running this command) +claude mcp list ``` @@ -734,6 +742,43 @@ Use xiaohongshu-mcp's video publishing feature. xiaohongshu-mcp publishing result +### 2.5. MCP FAQ + +--- + +**Q:** Why does the check login username display `xiaghgngshu-mcp`? +**A:** The username is hardcoded. + +--- + +**Q:** It shows publish success but the post doesn't actually appear? +**A:** Troubleshooting steps: +1. Re-publish using **non-headless mode**. +2. Try publishing with **different content**. +3. Login to RedNote web version and check if the account has been **restricted from web publishing due to risk control**. +4. Check if the **image size** is too large. +5. Make sure there are **no Chinese characters in the image path**. +6. If using network image URLs, confirm the **image links are accessible**. + +--- + +**Q:** The MCP program crashes on my device, how to resolve? +**A:** +1. It is recommended to **build from source**. +2. Or use **Docker to install xiaohongshu-mcp**, refer to: + - [Install xiaohongshu-mcp with Docker](https://github.com/xpzouying/xiaohongshu-mcp#:~:text=%E6%96%B9%E5%BC%8F%E4%B8%89%EF%BC%9A%E4%BD%BF%E7%94%A8%20Docker%20%E5%AE%B9%E5%99%A8%EF%BC%88%E6%9C%80%E7%AE%80%E5%8D%95%EF%BC%89) + - [X-MCP Project Page](https://github.com/xpzouying/x-mcp/) + +--- + +**Q:** When verifying MCP with `http://localhost:18060/mcp`, it shows connection error? +**A:** +- In a **Docker environment**, please use + [http://host.docker.internal:18060/mcp](http://host.docker.internal:18060/mcp) +- In a **non-Docker environment**, please use your **local IPv4 address** to access. + +--- + ## 3. 🌟 Community Showcases > 💡 **Highly Recommended**: These are real-world use cases from community contributors, featuring detailed configuration steps and practical experiences! @@ -753,11 +798,11 @@ Use xiaohongshu-mcp's video publishing feature. **Important: Before asking questions in the group, please make sure to read the README documentation thoroughly and check Issues first.** - + -| 【Feishu Group 3】: Scan to join | 【WeChat Group 10】: Scan to join | -| -------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | -| qrcode_2qun | WechatIMG119 | +| 【Feishu Group 3】: Scan to join | 【WeChat Group 14】: Scan to join | +| ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | +| qrcode_2qun | WechatIMG119 | ## 🙏 Thanks to Contributors ✨ @@ -790,6 +835,13 @@ Thanks to all friends who have contributed to this project! (In no particular or Carlo
Carlo
💻 hrz
hrz
💻 Ctrlz
Ctrlz
💻 + flippancy
flippancy
💻 + Yuhang Lu
Yuhang Lu
💻 + Bryan Thompson
Bryan Thompson
💻 + tan jun
tan jun
💻 + + + coldmountain
coldmountain
💻 @@ -801,8 +853,14 @@ Thanks to all friends who have contributed to this project! (In no particular or ### ✨ Special Thanks -| Contributors | -| --------------------------------------------------------------------------------------------------------------------------- | -| [
@wanpengxie](https://github.com/wanpengxie) | + + + + + + + + +
wanpengxie
@wanpengxie		tanxxjun321
@tanxxjun321		Angiin
@Angiin
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!