yfin-mcp 0.1.0__tar.gz → 0.2.5__tar.gz

{yfin_mcp-0.1.0/yfin_mcp.egg-info → yfin_mcp-0.2.5}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: yfin-mcp
-Version: 0.1.0
+Version: 0.2.5
 Summary: Enhanced Yahoo Finance MCP Server with intelligent pagination, caching, and LLM-optimized responses
 Author: AlexYoung (Original Author)
 Author-email: fritzprix <innocentevil0914@gmail.com>
-License: MIT
+License-Expression: MIT
 Project-URL: Homepage, https://github.com/fritzprix/yahoo-finance-mcp
 Project-URL: Repository, https://github.com/fritzprix/yahoo-finance-mcp
 Project-URL: Issues, https://github.com/fritzprix/yahoo-finance-mcp/issues
@@ -13,7 +13,6 @@ Keywords: mcp,model-context-protocol,yahoo-finance,yfinance,financial-data,stock
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Financial and Insurance Industry
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -173,11 +172,21 @@ With this MCP server, you can use Claude to:
   - pydantic
   - and other packages for data processing
 
-## Setup
+## Installation
+
+### From PyPI (Recommended)
+
+Install the package directly from PyPI:
+
+```bash
+pip install yfin-mcp
+```
+
+### From Source
 
 1. Clone this repository:
    ```bash
-   git clone https://github.com/Alex2Yang97/yahoo-finance-mcp.git
+   git clone https://github.com/fritzprix/yahoo-finance-mcp.git
    cd yahoo-finance-mcp
    ```
 
@@ -190,27 +199,47 @@ With this MCP server, you can use Claude to:
 
 ## Usage
 
-### Development Mode
+### Integration with Claude for Desktop
 
-You can test the server with MCP Inspector by running:
+After installing the package, you can integrate it with Claude for Desktop:
 
-```bash
-uv run server.py
-```
+1. **Install the package** (if not already installed):
+   ```bash
+   pip install yfin-mcp
+   ```
 
-This will start the server and allow you to test the available tools.
+2. **Configure Claude Desktop**:
+   - MacOS: Edit `~/Library/Application Support/Claude/claude_desktop_config.json`
+   - Windows: Edit `%APPDATA%\Claude\claude_desktop_config.json`
 
-### Integration with Claude for Desktop
+3. **Add the server configuration**:
 
-To integrate this server with Claude for Desktop:
+   **Using uvx (Recommended - No installation needed)**:
+   ```json
+   {
+     "mcpServers": {
+       "yfinance": {
+         "command": "uvx",
+         "args": ["yfin-mcp"]
+       }
+     }
+   }
+   ```
 
-1. Install Claude for Desktop to your local machine.
-2. Install VS Code to your local machine. Then run the following command to open the `claude_desktop_config.json` file:
-   - MacOS: `code ~/Library/Application\ Support/Claude/claude_desktop_config.json`
-   - Windows: `code $env:AppData\Claude\claude_desktop_config.json`
+   **Using Python directly (if installed via pip)**:
+   ```json
+   {
+     "mcpServers": {
+       "yfinance": {
+         "command": "python",
+         "args": ["-m", "yfin_mcp"]
+       }
+     }
+   }
+   ```
 
-3. Edit the Claude for Desktop config file, located at:
-   - macOS: 
+   **For development/source installation**:
+   - macOS:
      ```json
      {
        "mcpServers": {
@@ -218,7 +247,7 @@ To integrate this server with Claude for Desktop:
            "command": "uv",
            "args": [
              "--directory",
-             "/ABSOLUTE/PATH/TO/PARENT/FOLDER/yahoo-finance-mcp",
+             "/ABSOLUTE/PATH/TO/yahoo-finance-mcp",
              "run",
              "server.py"
            ]
@@ -234,7 +263,7 @@ To integrate this server with Claude for Desktop:
            "command": "uv",
            "args": [
              "--directory",
-             "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\yahoo-finance-mcp",
+             "C:\\ABSOLUTE\\PATH\\TO\\yahoo-finance-mcp",
              "run",
              "server.py"
            ]
@@ -243,9 +272,50 @@ To integrate this server with Claude for Desktop:
      }
      ```
 
-   - **Note**: You may need to put the full path to the uv executable in the command field. You can get this by running `which uv` on MacOS/Linux or `where uv` on Windows.
+4. **Restart Claude for Desktop**
+
+### Development Mode
+
+For testing with MCP Inspector:
+
+```bash
+# From source
+uv run yfin-mcp
+
+# Or if installed via pip
+python -m yfin_mcp
+```
+
+## Publishing to PyPI
+
+To build and publish the package, use the provided scripts. You can optionally provide an argument to bump the version:
+
+### Windows
+```bash
+# Just build and publish current version
+publish_package.bat
+
+# Bump version and then publish
+publish_package.bat patch
+publish_package.bat minor
+publish_package.bat major
+```
+
+### macOS/Linux
+```bash
+chmod +x publish_package.sh
+
+# Just build and publish current version
+./publish_package.sh
+
+# Bump version and then publish
+./publish_package.sh patch
+./publish_package.sh minor
+./publish_package.sh major
+```
 
-4. Restart Claude for Desktop
+> [!NOTE]
+> The scripts will build the package into the `dist/` directory and then use `twine` to upload it. Ensure you have your PyPI credentials configured in `~/.pypirc` (or `%HOME%\.pypirc` on Windows) or set the `TWINE_PASSWORD` environment variable.
 
 ## License
 

{yfin_mcp-0.1.0 → yfin_mcp-0.2.5}/README.md

@@ -140,11 +140,21 @@ With this MCP server, you can use Claude to:
   - pydantic
   - and other packages for data processing
 
-## Setup
+## Installation
+
+### From PyPI (Recommended)
+
+Install the package directly from PyPI:
+
+```bash
+pip install yfin-mcp
+```
+
+### From Source
 
 1. Clone this repository:
    ```bash
-   git clone https://github.com/Alex2Yang97/yahoo-finance-mcp.git
+   git clone https://github.com/fritzprix/yahoo-finance-mcp.git
    cd yahoo-finance-mcp
    ```
 
@@ -157,27 +167,47 @@ With this MCP server, you can use Claude to:
 
 ## Usage
 
-### Development Mode
+### Integration with Claude for Desktop
 
-You can test the server with MCP Inspector by running:
+After installing the package, you can integrate it with Claude for Desktop:
 
-```bash
-uv run server.py
-```
+1. **Install the package** (if not already installed):
+   ```bash
+   pip install yfin-mcp
+   ```
 
-This will start the server and allow you to test the available tools.
+2. **Configure Claude Desktop**:
+   - MacOS: Edit `~/Library/Application Support/Claude/claude_desktop_config.json`
+   - Windows: Edit `%APPDATA%\Claude\claude_desktop_config.json`
 
-### Integration with Claude for Desktop
+3. **Add the server configuration**:
 
-To integrate this server with Claude for Desktop:
+   **Using uvx (Recommended - No installation needed)**:
+   ```json
+   {
+     "mcpServers": {
+       "yfinance": {
+         "command": "uvx",
+         "args": ["yfin-mcp"]
+       }
+     }
+   }
+   ```
 
-1. Install Claude for Desktop to your local machine.
-2. Install VS Code to your local machine. Then run the following command to open the `claude_desktop_config.json` file:
-   - MacOS: `code ~/Library/Application\ Support/Claude/claude_desktop_config.json`
-   - Windows: `code $env:AppData\Claude\claude_desktop_config.json`
+   **Using Python directly (if installed via pip)**:
+   ```json
+   {
+     "mcpServers": {
+       "yfinance": {
+         "command": "python",
+         "args": ["-m", "yfin_mcp"]
+       }
+     }
+   }
+   ```
 
-3. Edit the Claude for Desktop config file, located at:
-   - macOS: 
+   **For development/source installation**:
+   - macOS:
      ```json
      {
        "mcpServers": {
@@ -185,7 +215,7 @@ To integrate this server with Claude for Desktop:
            "command": "uv",
            "args": [
              "--directory",
-             "/ABSOLUTE/PATH/TO/PARENT/FOLDER/yahoo-finance-mcp",
+             "/ABSOLUTE/PATH/TO/yahoo-finance-mcp",
              "run",
              "server.py"
            ]
@@ -201,7 +231,7 @@ To integrate this server with Claude for Desktop:
            "command": "uv",
            "args": [
              "--directory",
-             "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\yahoo-finance-mcp",
+             "C:\\ABSOLUTE\\PATH\\TO\\yahoo-finance-mcp",
              "run",
              "server.py"
            ]
@@ -210,9 +240,50 @@ To integrate this server with Claude for Desktop:
      }
      ```
 
-   - **Note**: You may need to put the full path to the uv executable in the command field. You can get this by running `which uv` on MacOS/Linux or `where uv` on Windows.
+4. **Restart Claude for Desktop**
+
+### Development Mode
+
+For testing with MCP Inspector:
+
+```bash
+# From source
+uv run yfin-mcp
+
+# Or if installed via pip
+python -m yfin_mcp
+```
+
+## Publishing to PyPI
+
+To build and publish the package, use the provided scripts. You can optionally provide an argument to bump the version:
+
+### Windows
+```bash
+# Just build and publish current version
+publish_package.bat
+
+# Bump version and then publish
+publish_package.bat patch
+publish_package.bat minor
+publish_package.bat major
+```
+
+### macOS/Linux
+```bash
+chmod +x publish_package.sh
+
+# Just build and publish current version
+./publish_package.sh
+
+# Bump version and then publish
+./publish_package.sh patch
+./publish_package.sh minor
+./publish_package.sh major
+```
 
-4. Restart Claude for Desktop
+> [!NOTE]
+> The scripts will build the package into the `dist/` directory and then use `twine` to upload it. Ensure you have your PyPI credentials configured in `~/.pypirc` (or `%HOME%\.pypirc` on Windows) or set the `TWINE_PASSWORD` environment variable.
 
 ## License
 

{yfin_mcp-0.1.0 → yfin_mcp-0.2.5}/pyproject.toml

@@ -4,11 +4,11 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "yfin-mcp"
-version = "0.1.0"
+version = "0.2.5"
 description = "Enhanced Yahoo Finance MCP Server with intelligent pagination, caching, and LLM-optimized responses"
 readme = "README.md"
 requires-python = ">=3.11"
-license = {text = "MIT"}
+license = "MIT"
 authors = [
     {name = "fritzprix", email = "innocentevil0914@gmail.com"},
     {name = "AlexYoung (Original Author)"}
@@ -27,7 +27,6 @@ classifiers = [
     "Development Status :: 4 - Beta",
     "Intended Audience :: Developers",
     "Intended Audience :: Financial and Insurance Industry",
-    "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
@@ -40,6 +39,9 @@ dependencies = [
     "pandas>=2.0.0",
 ]
 
+[project.scripts]
+yfin-mcp = "yfin_mcp.server:main"
+
 [project.urls]
 Homepage = "https://github.com/fritzprix/yahoo-finance-mcp"
 Repository = "https://github.com/fritzprix/yahoo-finance-mcp"

yfin_mcp-0.2.5/src/yfin_mcp/__init__.py

@@ -0,0 +1 @@
+# yfin_mcp package

yfin_mcp-0.2.5/src/yfin_mcp/__main__.py

@@ -0,0 +1,4 @@
+from .server import main
+
+if __name__ == "__main__":
+    main()

yfin_mcp-0.2.5/src/yfin_mcp/cache_manager.py

@@ -0,0 +1,150 @@
+"""
+Thread-safe LRU cache manager with TTL support for Yahoo Finance MCP server.
+"""
+
+import threading
+import time
+from collections import OrderedDict
+from typing import Any, Callable, Optional, Tuple
+
+
+class CacheManager:
+    """Thread-safe LRU cache with TTL (Time To Live) support."""
+    
+    def __init__(self, max_size: int = 100):
+        """
+        Initialize cache manager.
+        
+        Args:
+            max_size: Maximum number of entries in cache (LRU eviction)
+        """
+        self._cache: OrderedDict[str, Tuple[Any, float, float]] = OrderedDict()
+        self._max_size = max_size
+        self._lock = threading.Lock()
+        self._hits = 0
+        self._misses = 0
+    
+    def get(self, key: str) -> Optional[Tuple[Any, float]]:
+        """
+        Get value from cache if it exists and hasn't expired.
+        
+        Args:
+            key: Cache key
+            
+        Returns:
+            Tuple of (value, age_seconds) if found and valid, None otherwise
+        """
+        with self._lock:
+            if key not in self._cache:
+                self._misses += 1
+                return None
+            
+            value, timestamp, ttl = self._cache[key]
+            age = time.time() - timestamp
+            
+            # Check if expired
+            if age > ttl:
+                del self._cache[key]
+                self._misses += 1
+                return None
+            
+            # Move to end (most recently used)
+            self._cache.move_to_end(key)
+            self._hits += 1
+            return (value, age)
+    
+    def set(self, key: str, value: Any, ttl_seconds: float):
+        """
+        Set value in cache with TTL.
+        
+        Args:
+            key: Cache key
+            value: Value to cache
+            ttl_seconds: Time to live in seconds
+        """
+        with self._lock:
+            # Remove oldest if at capacity
+            if len(self._cache) >= self._max_size and key not in self._cache:
+                self._cache.popitem(last=False)
+            
+            self._cache[key] = (value, time.time(), ttl_seconds)
+            self._cache.move_to_end(key)
+    
+    def get_or_set(
+        self,
+        key: str,
+        factory_func: Callable[[], Any],
+        ttl_seconds: float
+    ) -> Tuple[Any, Optional[float]]:
+        """
+        Get from cache or compute and cache if missing/expired.
+        
+        Args:
+            key: Cache key
+            factory_func: Function to call if cache miss
+            ttl_seconds: TTL for new cache entries
+            
+        Returns:
+            Tuple of (value, age_seconds). age_seconds is None for cache miss.
+        """
+        # Try to get from cache
+        cached = self.get(key)
+        if cached is not None:
+            return cached
+        
+        # Cache miss - compute value
+        try:
+            value = factory_func()
+            self.set(key, value, ttl_seconds)
+            return (value, None)  # None age indicates fresh data
+        except Exception as e:
+            # Don't cache errors
+            raise e
+    
+    def clear(self):
+        """Clear all cache entries."""
+        with self._lock:
+            self._cache.clear()
+            self._hits = 0
+            self._misses = 0
+    
+    def get_stats(self) -> dict:
+        """
+        Get cache statistics.
+        
+        Returns:
+            Dict with hits, misses, size, and hit rate
+        """
+        with self._lock:
+            total = self._hits + self._misses
+            hit_rate = (self._hits / total * 100) if total > 0 else 0
+            
+            return {
+                "hits": self._hits,
+                "misses": self._misses,
+                "size": len(self._cache),
+                "max_size": self._max_size,
+                "hit_rate": f"{hit_rate:.1f}%"
+            }
+
+
+# Global cache instance
+_global_cache: Optional[CacheManager] = None
+_cache_lock = threading.Lock()
+
+
+def get_cache() -> CacheManager:
+    """
+    Get the global cache instance (singleton pattern).
+    
+    Returns:
+        Global CacheManager instance
+    """
+    global _global_cache
+    
+    if _global_cache is None:
+        with _cache_lock:
+            if _global_cache is None:
+                _global_cache = CacheManager(max_size=100)
+    
+    return _global_cache