win4r_arxiv_search_mcp_server
by win4rarXiv Search Integration for Claude
Overview
The arXiv Search Integration for Claude is a Model Context Protocol (MCP) server designed to facilitate the search and retrieval of academic papers from arXiv. This server enables users to access detailed information about academic papers, including metadata, summaries, and PDF links, directly through MCP tools.
Features
Resources
- Paper Access: Papers are accessible via
arxiv://paper/{id}URIs. - Metadata: Each paper includes title, authors, summary, publication date, and a PDF link.
- Structured Content: JSON mime type is used for structured content access.
Tools
- Search Papers: The
search_paperstool allows users to search for academic papers on arXiv. - Required Parameter:
query(e.g., 'machine learning', 'quantum physics'). - Optional Parameters:
max_results,sort_by, andstartfor pagination. - Output: Returns formatted results with paper details.
Development
Installation
To get started, install the necessary dependencies:
npm install
Building the Server
Build the server using:
npm run build
Development Mode
For development with auto-rebuild, use:
npm run watch
Configuration
Integration with Claude Desktop
To use the server with Claude Desktop, add the following configuration:
MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"arxiv-search": {
"command": "node",
"args": ["/path/to/arxiv-search/build/index.js"],
"disabled": false,
"alwaysAllow": []
}
}
}
Integration with VSCode and Roo Cline
Add the following configuration to: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
Debugging
Debugging MCP servers can be challenging due to stdio communication. Use the MCP Inspector for easier debugging:
npm run inspector
Usage Examples
Example Query
<use_mcp_tool>
<server_name>arxiv-search</server_name>
<tool_name>search_papers</tool_name>
<arguments>
{
"query": "machine learning",
"max_results": 5,
"sort_by": "relevance"
}
</arguments>
</use_mcp_tool>
Available Parameters
query: Search query (required).max_results: Maximum number of results to return (default: 10, max: 100).sort_by: Sort method ('relevance', 'lastUpdatedDate', 'submittedDate').start: Starting index for results (for pagination).
License
This project is licensed under the MIT License.
Demo
For a video demonstration, visit this link.
Contact
For further inquiries, contact the developer via WeChat: stoeng.
Invite Gmail Contacts
