Aminer MCP Server

🚀 AMiner MCP Server

A server based on the Model Context Protocol (MCP), offering powerful academic paper search and analysis capabilities through the AMiner API.

🚀 Quick Start

🔧 MCP Client Configuration

Add the following to your MCP client configuration file:

{
  "mcpServers": {
    "aminer": {
      "command": "npx",
      "args": ["-y", "@scipen/aminer-mcp-server"],
      "env": {
        "AMINER_API_KEY": "YOUR_AMINER_API_KEY"
      }
    }
  }
}

🚀 Manual Run

# Set your AMiner API key:
export AMINER_API_KEY="your_aminer_api_key_here"
# Start using npx
npx -y @scipen/aminer-mcp-server

✨ Features

🔍 Search Tools

• Keyword Search (search_papers_by_keyword) - Search for papers by keyword.
• Venue Search (search_papers_by_venue) - Search for papers in a specific journal/conference.
• Author Search (search_papers_by_author) - Search for papers by a specific author.
• Advanced Search (search_papers_advanced) - Multi - condition combined search.

🤖 AI Assistant

• Paper Search Assistant (paper_search_assistant) - An AI prompt template for academic research assistance.

⚙️ Search Options

• Pagination support (page number, number per page).
• Sorting options (by year or citation count).
• Display of detailed paper information.
• English interface in a professional academic format.

💻 Usage Examples

search_papers_by_keyword

Search for academic papers by keyword.

Parameters:

• keyword (string, required): Search keyword.
• page (number, optional): Page number, default is 0.
• size (number, optional): Number of papers per page, default is 10, maximum is 10.
• order (string, optional): Sorting method: 'year' or 'n_citation'.

Example:

{
  "keyword": "深度学习",
  "page": 0,
  "size": 5,
  "order": "n_citation"
}

search_papers_by_venue

Search for papers published in a specific journal/conference.

Parameters:

• venue (string, required): Journal/conference name.
• page (number, optional): Page number, default is 0.
• size (number, optional): Number of papers per page, default is 10, maximum is 10.
• order (string, optional): Sorting method: 'year' or 'n_citation'.

Example:

{
  "venue": "Nature",
  "page": 0,
  "size": 10,
  "order": "year"
}

search_papers_by_author

Search for papers published by a specific author.

Parameters:

• author (string, required): Author's name.
• page (number, optional): Page number, default is 0.
• size (number, optional): Number of papers per page, default is 10, maximum is 10.
• order (string, optional): Sorting method: 'year' or 'n_citation'.

Example:

{
  "author": "Geoffrey Hinton",
  "page": 0,
  "size": 10
}

search_papers_advanced

Supports advanced search with multiple conditions.

Parameters:

• keyword (string, optional): Search keyword.
• venue (string, optional): Journal/conference name.
• author (string, optional): Author's name.
• page (number, optional): Page number, default is 0.
• size (number, optional): Number of papers per page, default is 10, maximum is 10.
• order (string, optional): Sorting method: 'year' or 'n_citation'.

Note: At least one of keyword, venue, or author must be provided.

Example:

{
  "keyword": "自然语言处理",
  "author": "Yann LeCun",
  "page": 0,
  "size": 5,
  "order": "n_citation"
}

paper_search_assistant

An AI assistant prompt template for academic research.

Parameters:

• research_topic (string, required): Research topic or field.
• search_focus (string, optional): Search focus.
  • recent: Focus on the latest papers.
  • highly_cited: Focus on highly cited papers.
  • comprehensive: Balanced search (default).

Example:

{
  "research_topic": "计算机视觉中的注意力机制",
  "search_focus": "highly_cited"
}

📚 Documentation

Project Structure

src/
├── index.ts          # Main server file
├── aminer-client.ts  # AMiner API client
└── types.ts          # Type definitions

Available Scripts

• pnpm run build - Build the project.
• pnpm run start - Start the service.
• pnpm run dev - Development mode.
• pnpm run lint - Code inspection.
• pnpm test - Run tests.

Technology Stack

• Runtime: Node.js 18+
• Language: TypeScript
• Framework: Model Context Protocol SDK
• Package Manager: pnpm
• API: AMiner Open Platform API
• Protocol: JSON - RPC 2.0 (MCP)

📄 License

This project is licensed under the MIT License.

🤝 Contribution

Welcome to submit Issues and Pull Requests!

📞 Support

If you have any questions or need support, please add the enterprise WeChat of our assistant: