MCP Server Weread

🚀 WeChat Reading Tool Development Documentation

This documentation details a WeChat Reading tool, covering its core functions, technical implementation, and future expansion directions. It aims to assist developers in building and enhancing a reading - aid tool.

✨ Features

1. Bookshelf Data Retrieval

Function Description: Retrieve information about all books on the user's WeChat Reading bookshelf.

Input Parameters:

• None

Output Result:

{
  "bookshelf": [
    {
      "bookId": string,
      "title": string,
      "author": string,
      "cover": string,
      "progress": number,
      "readingTime": number,
      "lastReadingDate": number,
      "noteCount": number,
      "url": string
    }
  ]
}

Implementation Logic:

1. Call the WeChat Reading API to obtain bookshelf data.
2. Parse the returned JSON data and extract book information.
3. Format the output result.

2. Note Management

Function Description: Perform addition, deletion, and query operations on the user's notes.

Input Parameters:

• bookId: string (Required)
• chapterUid: string (Required)
• content: string (Required)

Output Result:

{
  "status": number,
  "message": string,
  "data": {
    "noteId": string,
    "bookId": string,
    "chapterUid": string,
    "content": string,
    "createTime": number
  }
}

Implementation Logic:

1. Retrieve the note list of the specified book.
2. Execute corresponding database or API operations based on the operation type.
3. Return the operation result.

3. Search Function

Function Description: Search for books or note content in the bookshelf.

Input Parameters:

• keyword: string (Required)

Output Result:

{
  "searchResults": [
    {
      "bookId": string,
      "title": string,
      "author": string,
      "contentExcerpt": string,
      "type": "book|note",
      "createTime": number
    }
  ],
  "total": number
}

Implementation Logic:

1. Traverse all book and note content.
2. Perform full - text matching using the keyword.
3. Return the matching results and sort them.

4. Recent Reading Records

Function Description: Retrieve the list of books the user has recently read.

Input Parameters:

• None

Output Result:

{
  "recentReading": [
    {
      "bookId": string,
      "title": string,
      "author": string,
      "cover": string,
      "readingTime": number,
      "progress": number,
      "lastReadingDate": number
    }
  ]
}

Implementation Logic:

1. Call the WeChat Reading API to obtain the reading history.
2. Parse and format the recent reading data.
3. Return the result.

🔧 Technical Details

1. Environment Variable Management

• Store sensitive information (such as Cookies) using the .env file or system environment variables.
• Support automatic retrieval of the latest Cookies through the Cookie Cloud service.

2. Error Handling

• Implement a comprehensive exception - catching mechanism, especially when API calls fail.
• Provide a reminder for expired Cookies and an automatic refresh function.

3. Performance Optimization

• Control the frequency of API calls to avoid triggering platform restrictions.
• Introduce a short - term caching mechanism to reduce redundant requests.

4. MCP Protocol Adaptation

• Ensure that the tool is compatible with MCP (Cross - platform Communication Protocol).
• Provide detailed logging and error reporting functions.

🚧 Future Expansion Directions

1. Feature Expansion

• Implement a book borrowing function to support book sharing among users.
• Develop a reading punch - in function to encourage users to maintain reading habits.
• Introduce a social interaction module to support operations such as commenting and liking.

2. Technology Integration

• Integrate an AI recommendation system to provide personalized book lists based on the user's reading history.
• Support multi - platform data synchronization to achieve a cross - device reading experience.
• Develop an offline reading function to optimize network dependency issues.

3. User Experience Optimization

• Implement an intelligent bookshelf layout, supporting custom classification and sorting.
• Provide multiple theme styles to meet the aesthetic needs of different users.
• Develop a voice - reading function to enhance reading convenience.

📝 Conclusion

This development documentation comprehensively introduces the core functional modules and technical implementation points of the WeChat Reading tool. By following the guidelines in this document, developers can quickly build a fully - featured reading - aid tool and perform personalized expansion and optimization on this basis.