all-in-mcp 0.2.3__tar.gz → 0.2.6__tar.gz

all_in_mcp-0.2.6/PKG-INFO

@@ -0,0 +1,129 @@
+Metadata-Version: 2.4
+Name: all-in-mcp
+Version: 0.2.6
+Summary: An MCP (Model Context Protocol) server providing daily-use utility functions and academic paper search capabilities
+Project-URL: Homepage, https://github.com/jiahaoxiang2000/all-in-mcp
+Project-URL: Repository, https://github.com/jiahaoxiang2000/all-in-mcp
+Project-URL: Documentation, https://github.com/jiahaoxiang2000/all-in-mcp/tree/main/docs
+Project-URL: Issues, https://github.com/jiahaoxiang2000/all-in-mcp/issues
+Author-email: isomo <jiahaoxiang2000@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: academic,iacr,mcp,model-context-protocol,papers,utilities
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: General
+Requires-Python: >=3.10
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: feedparser>=6.0.10
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: mcp>=1.9.4
+Requires-Dist: pypdf>=4.0.0
+Requires-Dist: requests>=2.31.0
+Provides-Extra: all
+Requires-Dist: psutil>=5.9.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: build>=1.0.0; extra == 'dev'
+Requires-Dist: mypy>=1.5.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Requires-Dist: twine>=4.0.0; extra == 'dev'
+Provides-Extra: system
+Requires-Dist: psutil>=5.9.0; extra == 'system'
+Description-Content-Type: text/markdown
+
+# All-in-MCP
+
+An MCP (Model Context Protocol) server that provides utility functions, including academic paper search capabilities.
+
+- [**Paper Tools overview _Video_**](https://www.bilibili.com/video/BV1RMKWzdEk8)
+- [_Overview PDF_](https://github.com/jiahaoxiang2000/tutor/blob/main/Apaper/setup.pdf)
+
+## Features
+
+This MCP server exposes the following daily-use utility tools as MCP endpoints:
+
+### Available Tools
+
+- **Academic Research**:
+  - `search-iacr-papers`: Search academic papers from IACR ePrint Archive
+  - `download-iacr-paper`: Download PDF of an IACR ePrint paper
+  - `read-iacr-paper`: Read and extract text content from an IACR ePrint paper PDF
+- **Bibliography Search**:
+  - `search-cryptobib-papers`: Search CryptoBib bibliography database for cryptography papers (structured metadata or raw BibTeX)
+- **Crossref Search**:
+  - `search-crossref-papers`: Search academic papers from Crossref database
+- **Google Scholar**:
+  - `search-google-scholar-papers`: Search academic papers across disciplines with citation data
+- **PDF Reading**:
+  - `read-pdf`: Read and extract text from local and online PDF files
+
+All tools are implemented as async MCP endpoints with proper validation and error handling.
+
+## Quick Start
+
+- [**Video for Env Setup**](https://www.bilibili.com/video/BV1cZKozaEjg)
+- [_Overview PDF_](https://github.com/jiahaoxiang2000/tutor/blob/main/Apaper/config.pdf)
+
+### Prerequisites
+
+- Python 3.12 or higher
+- UV package manager
+
+### Installation
+
+Install from PyPI (Recommended by `UV`)
+
+```bash
+uv pip install all-in-mcp
+```
+
+### Integration with MCP Clients Vscode
+
+Add this server to your MCP client configuration. The server runs using stdio transport.
+
+Example configuration for Vscode:
+
+```json .vscode/mcp.json
+{
+  "servers": {
+    "all-in-mcp": {
+      "type": "stdio",
+      "command": "uv",
+      "args": ["run", "all-in-mcp"]
+    }
+  }
+}
+```
+
+<details>
+<summary>Development</summary>
+
+For development setup and contribution guidelines, see the [Development Guide](docs/development.md).
+
+### Quick Development Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/jiahaoxiang2000/all-in-mcp.git
+cd all-in-mcp
+
+# Install with development dependencies
+uv sync --extra dev
+
+# Run tests
+uv run pytest
+```
+
+</details>

all_in_mcp-0.2.6/README.md

@@ -0,0 +1,84 @@
+# All-in-MCP
+
+An MCP (Model Context Protocol) server that provides utility functions, including academic paper search capabilities.
+
+- [**Paper Tools overview _Video_**](https://www.bilibili.com/video/BV1RMKWzdEk8)
+- [_Overview PDF_](https://github.com/jiahaoxiang2000/tutor/blob/main/Apaper/setup.pdf)
+
+## Features
+
+This MCP server exposes the following daily-use utility tools as MCP endpoints:
+
+### Available Tools
+
+- **Academic Research**:
+  - `search-iacr-papers`: Search academic papers from IACR ePrint Archive
+  - `download-iacr-paper`: Download PDF of an IACR ePrint paper
+  - `read-iacr-paper`: Read and extract text content from an IACR ePrint paper PDF
+- **Bibliography Search**:
+  - `search-cryptobib-papers`: Search CryptoBib bibliography database for cryptography papers (structured metadata or raw BibTeX)
+- **Crossref Search**:
+  - `search-crossref-papers`: Search academic papers from Crossref database
+- **Google Scholar**:
+  - `search-google-scholar-papers`: Search academic papers across disciplines with citation data
+- **PDF Reading**:
+  - `read-pdf`: Read and extract text from local and online PDF files
+
+All tools are implemented as async MCP endpoints with proper validation and error handling.
+
+## Quick Start
+
+- [**Video for Env Setup**](https://www.bilibili.com/video/BV1cZKozaEjg)
+- [_Overview PDF_](https://github.com/jiahaoxiang2000/tutor/blob/main/Apaper/config.pdf)
+
+### Prerequisites
+
+- Python 3.12 or higher
+- UV package manager
+
+### Installation
+
+Install from PyPI (Recommended by `UV`)
+
+```bash
+uv pip install all-in-mcp
+```
+
+### Integration with MCP Clients Vscode
+
+Add this server to your MCP client configuration. The server runs using stdio transport.
+
+Example configuration for Vscode:
+
+```json .vscode/mcp.json
+{
+  "servers": {
+    "all-in-mcp": {
+      "type": "stdio",
+      "command": "uv",
+      "args": ["run", "all-in-mcp"]
+    }
+  }
+}
+```
+
+<details>
+<summary>Development</summary>
+
+For development setup and contribution guidelines, see the [Development Guide](docs/development.md).
+
+### Quick Development Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/jiahaoxiang2000/all-in-mcp.git
+cd all-in-mcp
+
+# Install with development dependencies
+uv sync --extra dev
+
+# Run tests
+uv run pytest
+```
+
+</details>

{all_in_mcp-0.2.3 → all_in_mcp-0.2.6}/docs/api.md

@@ -108,6 +108,56 @@ URL: https://eprint.iacr.org/2023/1234
 [Full extracted text content]
 ```
 
+## Google Scholar Search
+
+### search-google-scholar-papers
+
+Search academic papers from Google Scholar. This provides broad coverage across multiple academic disciplines and includes citation information.
+
+**Parameters:**
+
+- `query` (string, required): Search query string (e.g., 'machine learning', 'neural networks')
+- `max_results` (integer, optional): Maximum number of results to return (default: 10)
+- `year_low` (integer, optional): Minimum publication year for filtering
+- `year_high` (integer, optional): Maximum publication year for filtering
+
+**Returns:**
+
+- List of papers with metadata (title, authors, citations, year, URL, abstract)
+
+**Example:**
+
+```json
+{
+  "name": "search-google-scholar-papers",
+  "arguments": {
+    "query": "deep learning transformers",
+    "max_results": 5,
+    "year_low": 2020,
+    "year_high": 2024
+  }
+}
+```
+
+**Response:**
+
+```
+Found 3 Google Scholar papers for query 'deep learning transformers' in year range (2020-2024):
+
+1. **Attention Is All You Need**
+   - Authors: Ashish Vaswani, Noam Shazeer, Niki Parmar
+   - Citations: 85234
+   - Year: 2017
+   - URL: https://papers.nips.cc/paper/7181-attention-is-all-you-need
+   - Abstract: The dominant sequence transduction models are based on complex recurrent or convolutional neural networks...
+```
+
+**Limitations:**
+
+- No direct PDF downloads (redirects to publisher websites)
+- Rate limiting may apply for frequent requests
+- Results may vary based on geographic location
+
 ## CryptoBib Bibliography Search
 
 ### search-cryptobib-papers

all_in_mcp-0.2.6/docs/google_scholar.md

@@ -0,0 +1,215 @@
+# Google Scholar Integration
+
+This document describes the Google Scholar integration in the all-in-mcp server.
+
+## Overview
+
+The Google Scholar integration provides academic paper searching capabilities through Google Scholar's web interface. Unlike other academic platforms, Google Scholar aggregates papers from multiple sources and provides citation counts and broader coverage of academic literature.
+
+## Features
+
+- **Paper Search**: Search for academic papers across multiple disciplines
+- **Citation Information**: Get citation counts for papers
+- **Multiple Source Coverage**: Access papers from various publishers and repositories
+- **Year-based Filtering**: Filter search results by publication year range
+
+## Available Tools
+
+### search-google-scholar-papers
+
+Search for academic papers using Google Scholar.
+
+**Parameters:**
+
+- `query` (required): Search query string (e.g., "machine learning", "neural networks")
+- `max_results` (optional): Maximum number of papers to return (default: 10, max: 100)
+- `year_low` (optional): Minimum publication year for filtering results
+- `year_high` (optional): Maximum publication year for filtering results
+
+**Example Usage:**
+
+```json
+{
+  "query": "deep learning transformers",
+  "max_results": 5,
+  "year_low": 2020,
+  "year_high": 2024
+}
+```
+
+**Returns:**
+
+- Paper title
+- Authors list
+- Citation count (when available)
+- Publication year (when available)
+- Paper URL
+- Abstract (truncated to 300 characters)
+
+## Limitations
+
+### No Direct PDF Access
+
+Google Scholar doesn't provide direct PDF downloads. Users need to:
+
+1. Use the provided paper URL to access the publisher's website
+2. Check if the paper is available through institutional access
+3. Look for open access versions on author websites or repositories
+
+### Rate Limiting
+
+Google Scholar implements rate limiting to prevent automated scraping:
+
+- The implementation includes random delays between requests (1-3 seconds)
+- Multiple rapid requests may result in temporary blocks
+- Consider using other sources (IACR, arXiv) for bulk operations
+
+### Search Result Variability
+
+- Results may vary based on geographic location and Google's algorithms
+- Some papers may not be accessible due to publisher restrictions
+- Citation counts may not be real-time accurate
+
+## Implementation Details
+
+### Web Scraping Approach
+
+The implementation uses web scraping with:
+
+- Random user agent rotation to avoid detection
+- BeautifulSoup for HTML parsing
+- Request session management for cookie handling
+- Error handling for network issues and parsing failures
+
+### Paper Data Extraction
+
+The parser extracts:
+
+- **Title**: From `h3.gs_rt` elements, cleaned of PDF/HTML markers
+- **Authors**: From `div.gs_a` elements, parsed from publication info
+- **Abstract**: From `div.gs_rs` elements when available
+- **Citations**: From citation links in `div.gs_fl` elements
+- **Year**: Extracted from publication information using regex patterns
+- **URL**: From title links to source papers
+
+### Error Handling
+
+- Network timeouts (30 seconds)
+- HTTP error responses (rate limiting, server errors)
+- Parsing failures for malformed HTML
+- Missing required paper elements
+
+## Best Practices
+
+### Responsible Usage
+
+1. **Respect Rate Limits**: Don't make too many requests in quick succession
+2. **Cache Results**: Store search results locally to avoid repeated queries
+3. **Use Appropriate Delays**: The implementation includes built-in delays
+4. **Monitor for Blocks**: Be prepared to handle temporary access restrictions
+
+### Query Optimization
+
+1. **Specific Terms**: Use specific academic terms for better results
+2. **Author Names**: Include author names when searching for specific papers
+3. **Publication Venues**: Include conference or journal names for focused searches
+4. **Year Ranges**: Use year filters to narrow down results
+
+### Integration with Other Sources
+
+Google Scholar works best when combined with other academic sources:
+
+- Use IACR for cryptography papers with PDF access
+- Use arXiv for preprints with full-text access
+- Use institutional repositories for open access papers
+
+## Example Responses
+
+### Successful Search
+
+```
+Found 3 Google Scholar papers for query 'machine learning healthcare':
+
+1. **Machine Learning in Healthcare: A Review**
+   - Authors: John Smith, Jane Doe, Bob Johnson
+   - Citations: 245
+   - Year: 2023
+   - URL: https://example.com/paper1
+   - Abstract: This comprehensive review examines the applications of machine learning techniques in healthcare settings, covering diagnostic imaging, predictive analytics, and treatment optimization...
+
+2. **Deep Learning for Medical Diagnosis**
+   - Authors: Alice Brown, Charlie Wilson
+   - Citations: 156
+   - Year: 2022
+   - URL: https://example.com/paper2
+   - Abstract: We present a novel deep learning framework for automated medical diagnosis using convolutional neural networks...
+```
+
+### Empty Results
+
+```
+No papers found for query: obscure search term in year range (2025-2030)
+```
+
+### Error Response
+
+```
+Error searching Google Scholar: HTTP 429 - Rate limit exceeded. Please try again later.
+```
+
+## Troubleshooting
+
+### Common Issues
+
+**No Results Found**
+
+- Check query spelling and syntax
+- Try broader search terms
+- Remove year filters if too restrictive
+- Verify network connectivity
+
+**Rate Limiting Errors**
+
+- Wait before making additional requests
+- Reduce the frequency of searches
+- Consider using other academic sources
+- Check if IP address is temporarily blocked
+
+**Parsing Errors**
+
+- Usually indicates changes in Google Scholar's HTML structure
+- Check logs for specific parsing failures
+- May require updates to the parsing logic
+
+### Development and Testing
+
+**Testing Considerations**
+
+- Use mock responses for unit tests to avoid rate limiting
+- Test with various query types and edge cases
+- Include tests for error conditions and edge cases
+- Verify handling of malformed or incomplete results
+
+**Debugging Tips**
+
+- Enable detailed logging to see request/response details
+- Check network connectivity and DNS resolution
+- Verify user agent and headers are being sent correctly
+- Test individual parsing functions with real HTML samples
+
+## Future Enhancements
+
+### Potential Improvements
+
+1. **Enhanced Parsing**: Better extraction of publication venues and DOIs
+2. **Citation Tracking**: Track citation networks and related papers
+3. **Advanced Filtering**: Filter by publication type, author affiliation
+4. **Result Caching**: Implement intelligent caching to reduce API calls
+5. **Proxy Support**: Add proxy rotation for high-volume usage
+
+### Integration Opportunities
+
+1. **Cross-Reference Validation**: Verify results against other academic databases
+2. **Full-Text Integration**: Combine with repository APIs for full-text access
+3. **Citation Analysis**: Integrate with citation analysis tools
+4. **Recommendation System**: Suggest related papers based on search history

{all_in_mcp-0.2.3 → all_in_mcp-0.2.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "all-in-mcp"
-version = "0.2.3"
+version = "0.2.6"
 description = "An MCP (Model Context Protocol) server providing daily-use utility functions and academic paper search capabilities"
 readme = "README.md"
 license = { text = "MIT" }

{all_in_mcp-0.2.3 → all_in_mcp-0.2.6}/src/all_in_mcp/academic_platforms/__init__.py

@@ -1,6 +1,7 @@
 # all_in_mcp/academic_platforms/__init__.py
 from .base import PaperSource
 from .cryptobib import CryptoBibSearcher
+from .google_scholar import GoogleScholarSearcher
 from .iacr import IACRSearcher
 
-__all__ = ["CryptoBibSearcher", "IACRSearcher", "PaperSource"]
+__all__ = ["CryptoBibSearcher", "GoogleScholarSearcher", "IACRSearcher", "PaperSource"]