# Creative Storyteller MCP Server for LM Studio

A Model Context Protocol (MCP) server that connects to a local LLM running in [LM Studio](https://lmstudio.ai/) (`http://localhost:1234/v1`) and instructs it to write highly creative, imaginative stories.

## Features
- Connects directly to local models hosted in LM Studio.
- High creativity parameters (`temperature: 0.85`, custom author system prompts).
- Supports customizable genres, tones, and word counts.
- Easy integration with VS Code, Claude Desktop, Antigravity, and Cursor.

## Setup Instructions

### 1. Start LM Studio
1. Open **LM Studio**.
2. Download your preferred model (e.g. `Mistral-7B`, `Llama-3-8B`).
3. Click the **Developer/Local Server** icon on the left navigation panel.
4. Load your model and click **Start Server** (`http://localhost:1234/v1`).

### 2. Install & Run MCP Server
```bash
# Clone the repository
git clone https://github.com/YOUR-USERNAME/creative-story-mcp.git
cd creative-story-mcp

# Create & activate a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Test with MCP Inspector
npx @modelcontextprotocol/inspector python server.py
```

## Adding to VS Code / Claude Desktop Configuration

Add the following block to your `mcp.json` settings:

```json
{
  "mcpServers": {
    "creative-storyteller": {
      "command": "python",
      "args": [
        "/path/to/creative-story-mcp/server.py"
      ]
    }
  }
}
```