Source: 青提学术 MCP
Project: https://github.com/aegean-org/qt-mcp
Overview
NoteExpress Web MCP connects your local NoteExpress Web database with various AI assistants through the Model Context Protocol (MCP), enabling natural-language-driven academic queries.
Note: If you have logged into multiple accounts, it will use the currently active account or the last login’s data.
Features
- Literature search — Search references by title or author, with pagination support
- PDF text extraction — Extract text content from PDF files
- Folder management — Retrieve references from specific folders
- Note management — Markdown-formatted note management system
- Reference creation — Save reference metadata to NoteExpress Web
System Requirements
- NoteExpress Web installed (v2.5.0 or later recommended)
- Supported on Linux, macOS, and Windows
Quick Start
1. Download
Visit the Releases page and download the latest binary:
- Windows:
qt-mcp-windows.zip - macOS:
qt-mcp-darwin.zip - Linux:
qt-mcp-linux.zip
2. Extract and Install
Extract the downloaded archive to a directory of your choice, for example:
- Windows:
C:\Program Files\ - macOS:
~/Downloads/ - Linux:
/usr/local/bin/or~/bin/
3. Configure Your AI Client
In your AI client’s MCP settings, add the following configuration:
{
"mcpServers": {
"qingti-mcp": {
"name": "NoteExpress Web",
"type": "stdio",
"description": "Academic paper management and research assistant",
"command": "/your/path/qt-mcp.exe",
"args": []
}
}
}Replace the command path with the actual path to the qt-mcp binary on your system.
4. Using the MCP
Once the configuration is added successfully, the NoteExpress Web MCP will appear in your AI client’s server list. Select it when asking questions.
Example prompts:
- “Find all references about ‘artificial intelligence’ in my NoteExpress Web library”
- “Get the references in the ‘Computer Science’ folder”
Available Tools
| Tool | Description | Parameters |
|---|---|---|
noteExpressWeb_search_articles |
Search references by title or author | query, page (optional), pageSize (optional) |
noteExpressWeb_get_article_pdf_content |
Get full-text content by reference ID or title | article_id |
noteExpressWeb_search_articles_by_folder |
Get references from a specified folder | folder |
noteExpressWeb_save_articles |
Save reference metadata to NoteExpress Web | data (JSON format) |
noteExpressWeb_save_note |
Save a Markdown note to a reference | content, article_id, note_id (optional) |
Supported AI Clients
- Claude Desktop
- Cherry Studio
- Cursor IDE
Troubleshooting
| Issue | Solution |
|---|---|
| Program won’t start | Ensure you downloaded the correct platform version |
| File download failed | Check network connection and data directory permissions |
| Configuration not found | Verify the data directory path is set correctly |
For questions or suggestions, please contact us through the project’s GitHub Issues page.
