Metadata-Version: 2.4
Name: lit-mcp
Version: 0.1.4
Summary: A MCP server layer for existing APIs from popular sources e.g. arXiv, DBLP, etc. to help researchers expedite literature review process using LLMs and MCP Clients like Claude, Cursor, etc.
Project-URL: Homepage, https://github.com/gauravfs-14/lit-mcp
Project-URL: Repository, https://github.com/gauravfs-14/lit-mcp
Project-URL: Issues, https://github.com/gauravfs-14/lit-mcp/issues
Author-email: Gaurab Chhetri <contact@gaurabchhetri.com.np>
License: MIT
License-File: LICENSE
Keywords: academic,arxiv,dblp,literature,mcp,papers,research
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.12
Requires-Dist: arxiv>=2.2.0
Requires-Dist: httpx>=0.28.1
Requires-Dist: mcp[cli]>=1.14.1
Requires-Dist: requests>=2.31.0
Description-Content-Type: text/markdown

# lit-mcp (Literature Review Assistant MCP Server)

<!-- MCP name format: io.github.gauravfs-14/lit-mcp -->

[![Python](https://img.shields.io/badge/Python-3.12+-blue.svg)](https://python.org)
[![MCP](https://img.shields.io/badge/MCP-Compatible-green.svg)](https://modelcontextprotocol.io)
[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![arXiv](https://img.shields.io/badge/arXiv-API-orange.svg)](https://arxiv.org)
[![DBLP](https://img.shields.io/badge/DBLP-API-red.svg)](https://dblp.org)
[![uv](https://img.shields.io/badge/uv-Package%20Manager-purple.svg)](https://github.com/astral-sh/uv)

A powerful Model Context Protocol (MCP) server that provides seamless access to academic literature databases, helping researchers accelerate their literature review process using LLMs and MCP clients like Claude, Cursor, and others.

## 🚀 Features

- **arXiv Integration**: Search and retrieve academic papers from arXiv
- **DBLP Integration**: Search computer science publications from DBLP database
- **MCP Compatible**: Works with any MCP client (Claude, Cursor, etc.)
- **Structured Data**: Returns well-formatted paper metadata
- **Fast & Reliable**: Built on FastMCP for optimal performance
- **Extensible**: Easy to add new academic databases

## 🚀 Quick Start

### 1. Install UV (one-time setup)

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

### 2. Add to MCP Client

Simply add lit-mcp to your MCP client configuration - `uvx` will handle the rest automatically!

## 🔌 MCP Client Integration

### Cursor IDE

Add to your MCP configuration (usually in `~/.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "lit-mcp": {
      "command": "uvx",
      "args": ["lit-mcp"]
    }
  }
}
```

<details>
<summary><strong>Other MCP Clients (Claude Desktop, etc.)</strong></summary>

Any MCP-compatible client can use lit-mcp with the same configuration pattern:

```json
{
  "mcpServers": {
    "lit-mcp": {
      "command": "uvx",
      "args": ["lit-mcp"]
    }
  }
}
```

**Example Usage:**

Once configured, you can use the available tools in your MCP client:

```text
Search for 5 papers on "machine learning transformers" using arXiv.
Search for computer science papers on "GPS trajectory" using DBLP.
```

</details>

## 📖 Available Tools

<details>
<summary><strong>arxiv_search</strong></summary>

Search for academic papers on arXiv with advanced query capabilities.

**Parameters:**

- `query` (string): Search query (supports arXiv syntax like `au:Author_Name`, `ti:Title`, etc.)
- `max_results` (integer, optional): Maximum number of results (default: 10)

**Returns:**

- List of paper objects with title, authors, publication date, summary, PDF URL, categories, and DOI

**Example Queries:**

```python
# Search by author
"au:Gaurab_Chhetri"

# Search by title keywords
"ti:machine learning"

# Search by category
"cat:cs.AI"

# Combined search
"au:Chhetri AND ti:transport"
```

</details>

<details>
<summary><strong>dblp_search</strong></summary>

Search for computer science publications in the DBLP database.

**Parameters:**

- `query` (string): Search query for computer science papers
- `max_results` (integer, optional): Maximum number of results (default: 10)

**Returns:**

- List of publication objects with title, authors, venue, volume, number, pages, publisher, year, type, access, key, DOI, electronic edition link, and DBLP URL

**Example Queries:**

```python
# Search for specific topics
"machine learning"
"computer vision"
"natural language processing"
"GPS trajectory"
"blockchain technology"
```

</details>

## 📊 Example Output

### arXiv Search Result

```json
{
  "title": "Model Context Protocols in Adaptive Transport Systems: A Survey",
  "authors": ["Gaurab Chhetri", "Shriyank Somvanshi", "..."],
  "published": "2025-08-26T17:58:56+00:00",
  "summary": "The rapid expansion of interconnected devices...",
  "entry_id": "http://arxiv.org/abs/2508.19239v1",
  "pdf_url": "http://arxiv.org/pdf/2508.19239v1",
  "categories": ["cs.AI"],
  "doi": null
}
```

### DBLP Search Result

```json
{
  "title": "GPS Trajectory Data Mining: A Survey",
  "authors": ["John Doe", "Jane Smith"],
  "venue": "IEEE Transactions on Knowledge and Data Engineering",
  "volume": "35",
  "number": "3",
  "pages": "1234-1250",
  "publisher": "IEEE",
  "year": "2023",
  "type": "Journal Articles",
  "access": "open",
  "key": "journals/tkde/DoeS23",
  "doi": "10.1109/TKDE.2023.1234567",
  "ee": "https://doi.org/10.1109/TKDE.2023.1234567",
  "url": "https://dblp.org/rec/journals/tkde/DoeS23.html"
}
```

## 🎯 Real-World Example

We tested this MCP by adding to Cursor. The [output](./example/small-lang-models.md) was generated based on the following prompt:

> I want to write a comprehensive survey paper on small language models. Can you create me a template along with fully detailed analysis of the contents? The writeup should be narrative (paragraph) style with minimal use of bullet points. Update to the file named small-lang-models.md and put the detailed contents there. Make sure to add accurate in-text citaitons as well to the content using markdown citation format, and also make sure to give the PDF links to all the papers. Use the arxiv tool.

## 🛠️ Development Installation

### Prerequisites

- Python 3.12
- uv package manager

<details>
<summary><strong>Setup & Development Configuration</strong></summary>

1. **Clone the repository**

   ```bash
   git clone https://github.com/gauravfs-14/lit-mcp.git
   cd lit-mcp
   ```

2. **Install dependencies**

   ```bash
   # Install UV if not already installed
   curl -LsSf https://astral.sh/uv/install.sh | sh
   
   # Install project dependencies
   uv sync
   ```

3. **Run the MCP server**

   ```bash
   uv run lit-mcp
   ```

### Development Setup for MCP Clients

If you're developing locally, you can use the development setup:

```json
{
  "mcpServers": {
    "lit-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<absolute_path_to_the_cloned_repo>",
        "run",
        "lit-mcp"
      ]
    }
  }
}
```

</details>

## 🤝 Contributing

We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for detailed information on how to contribute to this project.

<details>
<summary><strong>Quick Start for Contributors</strong></summary>

1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Make your changes
4. Run tests (`uv run python tests/test_basic.py`)
5. Commit your changes (`git commit -m 'Add amazing feature'`)
6. Push to the branch (`git push origin feature/amazing-feature`)
7. Open a Pull Request

For detailed guidelines, see [CONTRIBUTING.md](CONTRIBUTING.md).

</details>

This project follows a [Code of Conduct](CODE_OF_CONDUCT.md) to ensure a welcoming environment for all contributors.

## 🙏 Acknowledgments

- [arXiv](https://arxiv.org/) for providing free access to academic papers
- [DBLP](https://dblp.org/) for the comprehensive computer science bibliography
- [arxiv-py](https://pypi.org/project/arxiv/) developers for the excellent Python wrapper
- [DBLP API](https://dblp.org/faq/How+to+use+the+dblp+search+API) for providing direct access to computer science publications
- [FastMCP](https://github.com/modelcontextprotocol/fastmcp) for the MCP server framework

## 🆘 Support

If you encounter any issues or have questions:

1. Check the [Issues](https://github.com/gauravfs-14/lit-mcp/issues) page
2. Create a new issue with detailed information
3. Join our community discussions

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
