https://github.com/danimal141/arxiv-search-mcp
An MCP server that provides tools to search and fetch papers from arXiv.org.
https://github.com/danimal141/arxiv-search-mcp
deno mcp mcp-server
Last synced: 22 days ago
JSON representation
An MCP server that provides tools to search and fetch papers from arXiv.org.
- Host: GitHub
- URL: https://github.com/danimal141/arxiv-search-mcp
- Owner: danimal141
- License: mit
- Created: 2025-04-06T11:05:46.000Z (29 days ago)
- Default Branch: main
- Last Pushed: 2025-04-06T21:59:32.000Z (28 days ago)
- Last Synced: 2025-04-13T08:12:29.441Z (22 days ago)
- Topics: deno, mcp, mcp-server
- Language: TypeScript
- Homepage:
- Size: 507 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# arXiv Search MCP Server
An MCP server that provides tools to search and fetch papers from arXiv.org.
## Features
- Search papers by category
- Get latest papers sorted by submission date
- Formatted output with title, authors, summary, and link
## Development
### Prerequisites
- [Deno](https://deno.land/) installed on your system
- MCP compatible environment
### Setup
1. Clone the repository
2. Install dependencies:
```bash
deno cache --reload src/main.ts
```
### Running the Server
Development mode with file watching:
```bash
deno task dev
```
Build executable:
```bash
deno task compile
```
## Integration with Claude Desktop
Add the following configuration to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"arxiv-search-mcp": {
"command": "/path/to/dir/arxiv-search-mcp/bin/arxiv-search-mcp"
}
}
}
```
Replace `/path/to/dir` with the actual path to your compiled binary.
## Usage
Example usage screenshot:
The server provides a tool named `search_arxiv` that accepts the following parameters:
```typescript
{
"category": string, // arXiv category (e.g., cs.AI, cs.LG, astro-ph)
"max_results": number // Number of papers to fetch (1-100, default: 5)
}
```
### Example
Request:
```json
{
"category": "cs.AI",
"max_results": 5
}
```
This will return the 5 most recent papers from the Artificial Intelligence category.
### Available Categories
Some popular arXiv categories:
- `cs.AI`: Artificial Intelligence
- `cs.LG`: Machine Learning
- `cs.CL`: Computation and Language
- `cs.CV`: Computer Vision
- `cs.NE`: Neural and Evolutionary Computing
- `cs.RO`: Robotics
- `astro-ph`: Astrophysics
- `physics`: Physics
- `math`: Mathematics
- `q-bio`: Quantitative Biology
For a complete list of categories, visit [arXiv taxonomy](https://arxiv.org/category_taxonomy).
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.