@schaferandrew/mealie-mcp-server 0.1.1 → 0.1.3

package/README.md

@@ -24,13 +24,16 @@ Once connected, you can ask Claude things like:
 
 ## Installation
 
-Clone the repo and build:
+No installation required — run directly with `npx`:
 
 ```bash
-git clone https://github.com/your-username/mealie-mcp-server.git
-cd mealie-mcp-server
-npm install
-npm run build
+npx @schaferandrew/mealie-mcp-server
+```
+
+Or install globally if you prefer:
+
+```bash
+npm install -g @schaferandrew/mealie-mcp-server
 ```
 
 ## Claude Desktop Setup
@@ -44,8 +47,8 @@ Add the server to your Claude Desktop config file:
 {
   "mcpServers": {
     "mealie": {
-      "command": "/path/to/node",
-      "args": ["/path/to/mealie-mcp-server/dist/index.js"],
+      "command": "npx",
+      "args": ["-y", "@schaferandrew/mealie-mcp-server"],
       "env": {
         "MEALIE_URL": "http://your-mealie-instance:9000",
         "MEALIE_API_KEY": "your-api-key-here"
@@ -55,17 +58,12 @@ Add the server to your Claude Desktop config file:
 }
 ```
 
-To find your Node path:
-```bash
-which node
-```
-
-Then restart Claude Desktop. You should see the Mealie tools available in Claude.
+Restart Claude Desktop — you should see the Mealie tools available in Claude.
 
 ## Claude Code Setup
 
 ```bash
-claude mcp add mealie /path/to/node /path/to/mealie-mcp-server/dist/index.js \
+claude mcp add mealie -- npx -y @schaferandrew/mealie-mcp-server \
   -e MEALIE_URL=http://your-mealie-instance:9000 \
   -e MEALIE_API_KEY=your-api-key-here
 ```
@@ -76,62 +74,79 @@ Add `--scope global` to make it available in all projects.
 
 | Tool | Description |
 |---|---|
-| `search_recipes` | Search recipes by name or keyword |
-| `get_recipe` | Get full recipe details including ingredients & instructions |
-| `list_recipes` | List all recipes with optional tag/category filters |
-| `add_recipe_from_url` | Import a recipe by scraping a URL |
-| `search_by_ingredient` | Find recipes containing a specific ingredient |
+| `search_recipes` | Search recipes by name or keyword.<br>Example: `search_recipes pasta` |
+| `get_recipe` | Get full recipe details including ingredients & instructions.<br>Example: `get_recipe "Spaghetti Carbonara"` |
+| `list_recipes` | List all recipes, optionally filtered by tag or category.<br>Example: `list_recipes tag=vegetarian` |
+| `add_recipe_from_url` | Import a recipe by scraping a URL.<br>Example: `add_recipe_from_url https://example.com/recipe` |
+| `search_by_ingredient` | Find recipes containing a specific ingredient.<br>Example: `search_by_ingredient chicken` |
 
-## Project Structure
+## Configuration
 
-```
-mealie-mcp-server/
-├── src/
-│   ├── index.ts           # MCP server entry point
-│   ├── mealie-client.ts   # Mealie REST API wrapper
-│   ├── tools.ts           # Tool definitions, schemas, and handlers
-│   ├── config.ts          # Environment variable management
-│   ├── types.ts           # TypeScript interfaces
-│   └── test-connection.ts # Connection verification script
-├── .env.example
-├── package.json
-└── tsconfig.json
+| Environment Variable | Required | Description |
+|---|---|---|
+| `MEALIE_URL` | Yes | Base URL of your Mealie instance (e.g. `http://localhost:9000`) |
+| `MEALIE_API_KEY` | Yes | API token generated in your Mealie profile |
+
+## Security Notes
+
+- API keys are never logged — credentials are redacted from all error messages
+- Never hardcode credentials; use environment variables
+- `.env` is gitignored — `.env.example` is safe to commit
+
+## Development
+
+Clone the repo and install dependencies:
+
+```bash
+git clone https://github.com/schaferandrew/mealie-mcp-server.git
+cd mealie-mcp-server
+npm install
+npm run build
 ```
 
-## Testing the Connection
+Test your Mealie connection:
 
 ```bash
 MEALIE_URL=http://your-instance MEALIE_API_KEY=your-key npm run test-connection
 ```
 
-## Security Notes
+### Releasing a New Version
 
-- API keys are never logged — credentials are redacted from all error messages
-- Never hardcode credentials; use environment variables or a `.env` file
-- `.env` is gitignored — `.env.example` is safe to commit
+Releases are published to npm automatically when a GitHub Release is published.
 
-## Releasing a New Version
+**Step 1 — bump the version and open a PR:**
 
-Releases are published to npm automatically when a version tag is pushed to GitHub.
+```bash
+# Pick one based on the nature of your changes:
+npm version patch --no-git-tag-version   # 0.1.0 → 0.1.1  (bug fixes)
+npm version minor --no-git-tag-version   # 0.1.0 → 0.2.0  (new features)
+npm version major --no-git-tag-version   # 0.1.0 → 1.0.0  (breaking changes)
+
+VERSION=$(node -p "require('./package.json').version")
+
+git checkout -b release/v$VERSION
+git add package.json package-lock.json
+git commit -m "chore: bump version to $VERSION"
+git push -u origin release/v$VERSION
+gh pr create --title "chore: release v$VERSION" --body "Version bump to v$VERSION." --base main
+```
 
-### Steps
+**Step 2 — after the PR is merged, create the GitHub Release:**
 
-1. On a new branch, bump the version in `package.json`:
-   ```bash
-   npm version patch --no-git-tag-version   # 0.1.0 → 0.1.1  (bug fixes)
-   npm version minor --no-git-tag-version   # 0.1.0 → 0.2.0  (new features)
-   npm version major --no-git-tag-version   # 0.1.0 → 1.0.0  (breaking changes)
-   ```
+```bash
+# Make sure you're on main with the latest changes
+git checkout main && git pull origin main
 
-2. Commit, open a PR, and merge it into `main`.
+VERSION=$(node -p "require('./package.json').version")
 
-3. On GitHub, go to **Releases → Draft a new release**:
-   - Set the tag to match the version (e.g. `v0.1.1`)
-   - Click **Publish release**
+gh release create "v$VERSION" \
+  --title "v$VERSION" \
+  --generate-notes
+```
 
-GitHub Actions will publish to npm automatically when the release is published.
+GitHub Actions will publish to npm automatically.
 
-> **Note:** Make sure `NPM_TOKEN` is set in your GitHub repo under **Settings → Secrets and variables → Actions**.
+> **Note:** `NPM_TOKEN` must be set in your repo under **Settings → Secrets and variables → Actions**. Requires the [GitHub CLI](https://cli.github.com) (`gh`).
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@schaferandrew/mealie-mcp-server",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "MCP server for integrating Mealie recipe manager with Claude and Vivian",
   "main": "dist/index.js",
   "bin": {