Giiisp DeepResearch MCP Server

A Model Context Protocol (MCP) server for searching 160 million academic papers from the Giiisp database. This package provides seamless integration with AI assistants and research tools through the MCP protocol.

✨ Features

• 🔍 Smart Paper Search - Search through 160 million academic papers
• ⚡ Fast Response - 30-second timeout with optimized performance
• 🛡️ Robust Error Handling - Comprehensive error management
• 📊 Detailed Logging - Debug-friendly logging system
• 🔧 Easy Integration - Simple MCP protocol implementation
• 🌍 Multi-language Support - English search returns English results
• 📅 Date Filtering - Optional date range filtering

🚀 Quick Start

Installation

You can use this package directly with npx without global installation, or install it globally:

Option 1: Using npx (Recommended - No installation needed)

{
  "mcpServers": {
    "giisp-deepresearch": {
      "command": "npx",
      "args": ["-y", "giisp-deepresearch-mcp"]
    }
  }
}

Note: If you need to specify a specific version, use @ (not =):

{
  "mcpServers": {
    "giisp-deepresearch": {
      "command": "npx",
      "args": ["-y", "[email protected]"]
    }
  }
}

⚠️ Important: Use @ to specify version, not =.

• ✅ Correct: [email protected]
• ❌ Wrong: giisp-deepresearch-mcp=1.0.8

Option 2: Global Installation

npm install -g giisp-deepresearch-mcp

Then use:

{
  "mcpServers": {
    "giisp-deepresearch": {
      "command": "giisp-deepresearch"
    }
  }
}

Integration with Claude Desktop

To use this MCP server with Claude Desktop, add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "giisp-deepresearch": {
      "command": "npx",
      "args": ["-y", "giisp-deepresearch-mcp"]
    }
  }
}

After adding this configuration, restart Claude Desktop and you'll be able to search academic papers directly through the MCP interface.

Development Installation

git clone https://github.com/giisp/giisp-deepresearch-mcp.git
cd giisp-deepresearch-mcp
npm install
npm start

📖 Usage

MCP Tool Integration

The server provides a DeepResearch tool for searching academic papers:

Parameters:

• titleAndAbs (string, required): Search keywords for paper titles and abstracts (English recommended)
• startDate (string, optional): Start date in yyyy-MM-dd format
• endDate (string, optional): End date in yyyy-MM-dd format

Examples:

Basic search:

{
  "name": "DeepResearch",
  "arguments": {
    "titleAndAbs": "artificial intelligence"
  }
}

Search with date range:

{
  "name": "DeepResearch",
  "arguments": {
    "titleAndAbs": "artificial intelligence",
    "startDate": "2020-01-01",
    "endDate": "2024-12-31"
  }
}

Response Format:

{
  "success": true,
  "status": 200,
  "data": {
    // API response data with paper information
  },
  "message": "论文搜索完成"
}

🔧 Technical Details

• Timeout: 30 seconds
• Headers: Automatic Content-Type and User-Agent
• Error Handling: Distinguishes between network, API, and timeout errors
• Logging: Detailed request and response logging

🛠️ Error Handling

The server handles the following error types:

• Timeout Errors: Requests exceeding 30 seconds
• Network Errors: Unable to connect to API server
• API Errors: Server returning error status codes
• Parameter Errors: Missing required parameters or incorrect types

🔧 Troubleshooting

Connection Failed Error

If you see "Failed to connect" error, check the following:

1. Verify Configuration Format: Make sure you're using the correct format:

   {
     "mcpServers": {
       "giisp-deepresearch": {
         "command": "npx",
         "args": ["-y", "giisp-deepresearch-mcp"]
       }
     }
   }

2. Version Specification: If specifying a version, use @ not =:

   • ✅ Correct: [email protected]
   • ❌ Wrong: giisp-deepresearch-mcp=1.0.8

3. Check Node.js Version: Ensure you have Node.js 18+ installed:

   node --version

4. Test Server Manually: Test if the server can start:

   npx -y giisp-deepresearch-mcp

5. Restart Claude Desktop: After changing configuration, completely restart Claude Desktop.

🧪 Testing

Run the test suite:

npm test

This will test:

• API connectivity
• Parameter validation
• Error handling

📁 Project Structure

├── server.js              # Main server file
├── package.json           # Project configuration and dependencies
├── README.md             # Project documentation
├── LICENSE               # MIT License
├── .gitignore           # Git ignore rules
└── test/
    └── test-api.js       # Test suite

🚀 Development

Debug Mode

Run in debug mode with Node.js debugger:

npm run dev

Set breakpoints in your debugger for development.

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Submit a pull request

📄 License

MIT License - see LICENSE file for details.