rowan-mcp 0.1.0__tar.gz → 1.0.0__tar.gz

{rowan_mcp-0.1.0 → rowan_mcp-1.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rowan-mcp
-Version: 0.1.0
+Version: 1.0.0
 Summary: Model Context Protocol server for Rowan computational chemistry platform
 Project-URL: Homepage, https://github.com/k-yenko/rowan-mcp
 Author-email: Katherine Yenko <katherineyenko@example.com>
@@ -50,31 +50,38 @@ That's it - no command line setup needed!
 
 ---
 
-## **Manual Installation**
+## **Package Installation**
 
-**For developers or users who prefer command-line setup:**
+### **Using uv (recommended):**
+```bash
+# Install the package
+uv add rowan-mcp
+```
 
-### **1. Clone and Setup**
+### **Using pip:**
 ```bash
-git clone https://github.com/k-yenko/rowan-mcp.git
-cd rowan-mcp
-uv sync
+# Install the package
+pip install rowan-mcp
+
+# Or in a virtual environment
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+pip install rowan-mcp
 ```
 
-### **2. Get API Key**
-- Visit [labs.rowansci.com](https://labs.rowansci.com)
-- Create free account → Generate API key
+### **Get API Key & Configure**
 
-### **3. Configure Your MCP Client**
+1. **Get your API key**: Visit [labs.rowansci.com](https://labs.rowansci.com) → Create account → Generate API key
 
-**Claude Desktop Example:**
+2. **Configure your MCP client** (e.g., Claude Code, VSCode, Cursor, etc.):
+
+**With uv:**
 ```json
 {
   "mcpServers": {
     "rowan": {
       "command": "uv",
-      "args": ["run", "python", "-m", "rowan_mcp"],
-      "cwd": "/path/to/rowan-mcp",
+      "args": ["run", "rowan-mcp"],
       "env": {
         "ROWAN_API_KEY": "your_api_key_here"
       }
@@ -83,72 +90,76 @@ uv sync
 }
 ```
 
-*Replace `/path/to/rowan-mcp` with the actual path where you cloned the repository*
-
-**To find your path:**
-```bash
-# After cloning, run this in the rowan-mcp directory:
-pwd
-# Copy the output and use it as your "cwd" value
+**With pip/system Python:**
+```json
+{
+  "mcpServers": {
+    "rowan": {
+      "command": "rowan-mcp",
+      "env": {
+        "ROWAN_API_KEY": "your_api_key_here"
+      }
+    }
+  }
+}
 ```
 
-### **4. Start Using**
+### **Start Using**
 Ask your AI: *"Calculate the pKa of aspirin"* or *"Optimize the geometry of caffeine"*
 
-### **Alternative: Use .env file**
-Instead of putting your API key in the MCP config, create a `.env` file:
+---
+
+## **Development Installation**
+
+**For developers or contributors:**
+
+### **1. Clone and Setup**
 ```bash
-# In the rowan-mcp directory:
-echo "ROWAN_API_KEY=your_actual_api_key_here" > .env
+git clone https://github.com/k-yenko/rowan-mcp.git
+cd rowan-mcp
+uv sync
 ```
 
-Then use this simpler config (no env section needed):
+### **2. Configure for Development**
 ```json
 {
   "mcpServers": {
     "rowan": {
       "command": "uv",
       "args": ["run", "python", "-m", "rowan_mcp"],
-      "cwd": "/path/to/rowan-mcp"
+      "cwd": "/path/to/rowan-mcp",
+      "env": {
+        "ROWAN_API_KEY": "your_api_key_here"
+      }
     }
   }
 }
 ```
 
+*Replace `/path/to/rowan-mcp` with your actual clone path. Find it with `pwd` in the project directory.*
+
 ---
 
 ## **What You Can Do** 
 
 Ask the LLM to:
 - **Calculate drug properties**: *"Predict drug-likeness of aspirin"*
-- **Optimize molecular structures**: *"Optimize the geometry of aspirin"*  
+- **Optimize molecular structures**: *"Optimize the geometry of aspirin"* 
 - **Predict chemical behavior**: *"What's the pKa of acetic acid?"*
 - **Run calculations**: *"Calculate the HOMO and LUMO of benzene"*
 
 ## **System Requirements**
 
 - **Python 3.10+** (Python 3.11+ recommended)
-- **[uv](https://docs.astral.sh/uv/) package manager** 
+- **Package manager**: [uv](https://docs.astral.sh/uv/) (recommended) or pip
 - **Rowan API key** (free at [labs.rowansci.com](https://labs.rowansci.com))
-- **MCP-compatible client** (Claude Desktop, Continue, etc.)
-
-## **Testing Your Setup**
-
-You can test the server directly:
-```bash
-# In the rowan-mcp directory:
-uv run python -m rowan_mcp --help
-```
+- **MCP-compatible client** (Claude Desktop, etc.)
 
-## **Development**
 
-The installation above is the same for development! Additional commands:
+**Development commands** (if you cloned the repo):
 ```bash
-# Run server in HTTP/SSE mode  
+# Run from source
 uv run python -m rowan_mcp --http
-
-# Run server in STDIO mode (default)
-uv run python -m rowan_mcp
 ```
 
 ---
@@ -214,3 +225,21 @@ If you use this MCP tool in your research, please cite the underlying Rowan plat
 Rowan Scientific. https://www.rowansci.com (accessed 2025-07-01).
 
 For complete citation information including specific computational engines, methods, and workflows used in your calculations, please refer to [Rowan's citation guidelines](https://docs.rowansci.com/citations).
+
+---
+
+## **Publishing (Maintainer Notes)**
+
+To publish a new version to PyPI:
+
+```bash
+# Update version in pyproject.toml and rowan_mcp/__init__.py
+# Build the package
+uv build
+
+# Publish to PyPI (requires API token)
+uv publish
+
+# Or publish to TestPyPI first
+uv publish --index-url https://test.pypi.org/simple/
+```

{rowan_mcp-0.1.0 → rowan_mcp-1.0.0}/README.md

@@ -18,31 +18,38 @@ That's it - no command line setup needed!
 
 ---
 
-## **Manual Installation**
+## **Package Installation**
 
-**For developers or users who prefer command-line setup:**
+### **Using uv (recommended):**
+```bash
+# Install the package
+uv add rowan-mcp
+```
 
-### **1. Clone and Setup**
+### **Using pip:**
 ```bash
-git clone https://github.com/k-yenko/rowan-mcp.git
-cd rowan-mcp
-uv sync
+# Install the package
+pip install rowan-mcp
+
+# Or in a virtual environment
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+pip install rowan-mcp
 ```
 
-### **2. Get API Key**
-- Visit [labs.rowansci.com](https://labs.rowansci.com)
-- Create free account → Generate API key
+### **Get API Key & Configure**
 
-### **3. Configure Your MCP Client**
+1. **Get your API key**: Visit [labs.rowansci.com](https://labs.rowansci.com) → Create account → Generate API key
 
-**Claude Desktop Example:**
+2. **Configure your MCP client** (e.g., Claude Code, VSCode, Cursor, etc.):
+
+**With uv:**
 ```json
 {
   "mcpServers": {
     "rowan": {
       "command": "uv",
-      "args": ["run", "python", "-m", "rowan_mcp"],
-      "cwd": "/path/to/rowan-mcp",
+      "args": ["run", "rowan-mcp"],
       "env": {
         "ROWAN_API_KEY": "your_api_key_here"
       }
@@ -51,72 +58,76 @@ uv sync
 }
 ```
 
-*Replace `/path/to/rowan-mcp` with the actual path where you cloned the repository*
-
-**To find your path:**
-```bash
-# After cloning, run this in the rowan-mcp directory:
-pwd
-# Copy the output and use it as your "cwd" value
+**With pip/system Python:**
+```json
+{
+  "mcpServers": {
+    "rowan": {
+      "command": "rowan-mcp",
+      "env": {
+        "ROWAN_API_KEY": "your_api_key_here"
+      }
+    }
+  }
+}
 ```
 
-### **4. Start Using**
+### **Start Using**
 Ask your AI: *"Calculate the pKa of aspirin"* or *"Optimize the geometry of caffeine"*
 
-### **Alternative: Use .env file**
-Instead of putting your API key in the MCP config, create a `.env` file:
+---
+
+## **Development Installation**
+
+**For developers or contributors:**
+
+### **1. Clone and Setup**
 ```bash
-# In the rowan-mcp directory:
-echo "ROWAN_API_KEY=your_actual_api_key_here" > .env
+git clone https://github.com/k-yenko/rowan-mcp.git
+cd rowan-mcp
+uv sync
 ```
 
-Then use this simpler config (no env section needed):
+### **2. Configure for Development**
 ```json
 {
   "mcpServers": {
     "rowan": {
       "command": "uv",
       "args": ["run", "python", "-m", "rowan_mcp"],
-      "cwd": "/path/to/rowan-mcp"
+      "cwd": "/path/to/rowan-mcp",
+      "env": {
+        "ROWAN_API_KEY": "your_api_key_here"
+      }
     }
   }
 }
 ```
 
+*Replace `/path/to/rowan-mcp` with your actual clone path. Find it with `pwd` in the project directory.*
+
 ---
 
 ## **What You Can Do** 
 
 Ask the LLM to:
 - **Calculate drug properties**: *"Predict drug-likeness of aspirin"*
-- **Optimize molecular structures**: *"Optimize the geometry of aspirin"*  
+- **Optimize molecular structures**: *"Optimize the geometry of aspirin"* 
 - **Predict chemical behavior**: *"What's the pKa of acetic acid?"*
 - **Run calculations**: *"Calculate the HOMO and LUMO of benzene"*
 
 ## **System Requirements**
 
 - **Python 3.10+** (Python 3.11+ recommended)
-- **[uv](https://docs.astral.sh/uv/) package manager** 
+- **Package manager**: [uv](https://docs.astral.sh/uv/) (recommended) or pip
 - **Rowan API key** (free at [labs.rowansci.com](https://labs.rowansci.com))
-- **MCP-compatible client** (Claude Desktop, Continue, etc.)
-
-## **Testing Your Setup**
-
-You can test the server directly:
-```bash
-# In the rowan-mcp directory:
-uv run python -m rowan_mcp --help
-```
+- **MCP-compatible client** (Claude Desktop, etc.)
 
-## **Development**
 
-The installation above is the same for development! Additional commands:
+**Development commands** (if you cloned the repo):
 ```bash
-# Run server in HTTP/SSE mode  
+# Run from source
 uv run python -m rowan_mcp --http
-
-# Run server in STDIO mode (default)
-uv run python -m rowan_mcp
 ```
 
 ---
@@ -182,3 +193,21 @@ If you use this MCP tool in your research, please cite the underlying Rowan plat
 Rowan Scientific. https://www.rowansci.com (accessed 2025-07-01).
 
 For complete citation information including specific computational engines, methods, and workflows used in your calculations, please refer to [Rowan's citation guidelines](https://docs.rowansci.com/citations).
+
+---
+
+## **Publishing (Maintainer Notes)**
+
+To publish a new version to PyPI:
+
+```bash
+# Update version in pyproject.toml and rowan_mcp/__init__.py
+# Build the package
+uv build
+
+# Publish to PyPI (requires API token)
+uv publish
+
+# Or publish to TestPyPI first
+uv publish --index-url https://test.pypi.org/simple/
+```

{rowan_mcp-0.1.0 → rowan_mcp-1.0.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "rowan-mcp"
-version = "0.1.0"
+version = "1.0.0"
 description = "Model Context Protocol server for Rowan computational chemistry platform"
 authors = [
     {name = "Katherine Yenko", email = "katherineyenko@example.com"}

{rowan_mcp-0.1.0 → rowan_mcp-1.0.0}/rowan_mcp/__init__.py

@@ -5,7 +5,7 @@ This package provides MCP (Model Context Protocol) server functionality
 for integrating with Rowan's computational chemistry platform.
 """
 
-__version__ = "0.1.0"
+__version__ = "1.0.0"
 __author__ = "Rowan MCP Team"
 __description__ = "MCP server for Rowan computational chemistry platform"