@stellisoft/stellify-mcp 0.1.0 → 0.1.1

package/README.md

@@ -1,81 +1,99 @@
 # Stellify MCP Server
 
-Model Context Protocol (MCP) server for Stellify - the AI-native code generation platform.
+[![npm version](https://badge.fury.io/js/@stellisoft%2Fstellify-mcp.svg)](https://www.npmjs.com/package/@stellisoft/stellify-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Model Context Protocol (MCP) server for [Stellify](https://stellisoft.com) - the AI-native code generation platform.
 
 ## What is This?
 
-This MCP server lets AI assistants (like Claude) interact with your Stellify projects to build Laravel applications incrementally. Instead of generating full code files at once, AI can:
+This MCP server lets AI assistants (like Claude Desktop) interact with your Stellify projects to build Laravel applications incrementally. Instead of generating full code files at once, AI can:
 
-1. Create file structures (classes, controllers, models)
-2. Add method signatures
-3. Parse method bodies statement-by-statement
-4. Search existing code
+- 🏗️ Create file structures (classes, controllers, models, middleware)
+- 📝 Add method signatures with type hints
+- 🔍 Parse PHP code into structured JSON (statement-by-statement)
+- 🔎 Search existing code in your projects
+- 🚀 Build Laravel applications through natural conversation
 
-## Installation
+## Quick Start
 
 ### Prerequisites
 
-- Node.js 18 or higher
-- A Stellify account with API access
-- Claude Desktop (or another MCP-compatible client)
+- **Node.js 18 or higher**
+- **A Stellify account** - Sign up at [stellisoft.com](https://stellisoft.com)
+- **Claude Desktop** (or another MCP-compatible AI client)
 
-### Setup
+### Installation
 
-1. **Install dependencies:**
-```bash
-cd /Users/matthewanderson/stellify-mcp
-npm install
-```
+Install globally via npm:
 
-2. **Build the TypeScript:**
 ```bash
-npm run build
+npm install -g @stellisoft/stellify-mcp
 ```
 
-3. **Create environment file:**
-```bash
-cp .env.example .env
-```
+### Configuration
 
-4. **Get your Stellify API token:**
-   - Log into Stellify web interface
-   - Go to Settings → API Tokens
-   - Create a new token
-   - Copy the token
+1. **Get your Stellify API token:**
+   - Log into [Stellify](https://stellisoft.com)
+   - Navigate to Settings → API Tokens
+   - Click "Create New Token"
+   - Copy your token
 
-5. **Configure the .env file:**
-```bash
-# Edit .env
-STELLIFY_API_URL=https://stellisoft.com/api/v1
-STELLIFY_API_TOKEN=your-token-here
-```
+2. **Configure Claude Desktop:**
+
+   Edit your Claude Desktop configuration file:
+   - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+   - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+   - **Linux:** `~/.config/claude/claude_desktop_config.json`
+
+   Add the Stellify MCP server:
 
-## Configure Claude Desktop
+   ```json
+   {
+     "mcpServers": {
+       "stellify": {
+         "command": "stellify-mcp",
+         "env": {
+           "STELLIFY_API_URL": "https://api.stellisoft.com/v1",
+           "STELLIFY_API_TOKEN": "your-token-here"
+         }
+       }
+     }
+   }
+   ```
 
-Add this to your Claude Desktop config file:
+3. **Restart Claude Desktop**
 
-**Location:** `~/.config/claude/config.json` (Linux/Mac) or `%APPDATA%\Claude\config.json` (Windows)
+That's it! The Stellify tools should now be available in Claude Desktop.
 
-```json
-{
-  "mcpServers": {
-    "stellify": {
-      "command": "node",
-      "args": ["/Users/matthewanderson/stellify-mcp/dist/index.js"],
-      "env": {
-        "STELLIFY_API_URL": "https://stellisoft.com/api/v1",
-        "STELLIFY_API_TOKEN": "your-token-here"
-      }
-    }
-  }
-}
+## Usage
+
+Once configured, you can talk to Claude naturally to build Laravel applications:
+
+### Example Conversations
+
+**Create a new controller:**
+```
+"Create a UserController in my Stellify project"
 ```
 
-**Important:** Replace `/Users/matthewanderson/stellify-mcp` with the actual path and `your-token-here` with your real token.
+**Add methods:**
+```
+"Add a method called 'store' that takes a Request parameter and returns a JsonResponse"
+```
 
-## Restart Claude Desktop
+**Implement method logic:**
+```
+"Add this implementation to the store method:
+$user = User::create($request->validated());
+return response()->json($user, 201);"
+```
 
-After adding the configuration, restart Claude Desktop for the changes to take effect.
+**Search your codebase:**
+```
+"Search for all controller files in my project"
+"Find methods related to authentication"
+```
 
 ## Available Tools
 
@@ -136,18 +154,17 @@ Search for files in the project.
 - `name` (optional): File name pattern
 - `type` (optional): File type filter
 
-## Usage Example
+## How Stellify Works
 
-Once configured, you can talk to Claude naturally:
+Stellify stores your Laravel application code as **structured JSON** in a database, not text files. This architecture enables:
 
-```
-User: "Create a Calculator service in my Stellify project abc-123"
+- **Surgical precision:** AI modifies specific methods without touching other code
+- **Query your codebase like data:** Find all methods that use a specific class
+- **Instant refactoring:** Rename a method across your entire application instantly
+- **Version control at the statement level:** Track changes to individual code statements
+- **AI-native development:** Give AI granular access without worrying about breaking existing code
 
-Claude will:
-1. Call create_file to create Calculator.php
-2. Call create_method to add an "add" method
-3. Call add_method_body to implement "return $a + $b;"
-```
+When you build with Stellify through this MCP server, code is parsed into structured data and can be assembled back into executable PHP when you deploy.
 
 ## The Incremental Workflow
 
@@ -219,13 +236,52 @@ After Phase 1 works, we'll add:
 - Rich metadata extraction
 - Usage statistics
 
+## Troubleshooting
+
+### Claude Desktop doesn't see the tools
+
+1. Verify the configuration file path is correct for your OS
+2. Check that the Stellify API token is valid
+3. Restart Claude Desktop completely (Quit, not just close window)
+4. Check Claude Desktop logs for error messages
+
+### API connection errors
+
+- Verify your API token at https://stellisoft.com/settings/tokens
+- Check that `STELLIFY_API_URL` is correct
+- Ensure your Stellify account is active
+
+### Installation issues
+
+```bash
+# Clear npm cache and reinstall
+npm cache clean --force
+npm uninstall -g @stellisoft/stellify-mcp
+npm install -g @stellisoft/stellify-mcp
+```
+
+## Contributing
+
+We welcome contributions! Please see our contributing guidelines and feel free to submit pull requests.
+
 ## Support
 
 For issues or questions:
-- GitHub: https://github.com/stellisoft/stellify-mcp
-- Email: support@stellisoft.com
-- Docs: https://stellisoft.com/docs/mcp
+- **GitHub Issues:** [Report a bug or request a feature](https://github.com/Stellify-Software-Ltd/stellify-mcp/issues)
+- **Email:** support@stellisoft.com
+- **Documentation:** https://stellisoft.com/docs
+- **Discord:** Join our community (coming soon)
+
+## About Stellify
+
+Stellify is building the future of AI-native software development. By storing code as structured data instead of text files, we enable a new paradigm where AI and humans collaborate seamlessly to build better software, faster.
+
+Learn more at [stellisoft.com](https://stellisoft.com)
 
 ## License
 
-MIT
+MIT License - see [LICENSE](LICENSE) file for details
+
+---
+
+Built with ❤️ by the Stellify team

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stellisoft/stellify-mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "MCP server for Stellify - AI-native code generation platform",
   "main": "dist/index.js",
   "type": "module",
@@ -17,10 +17,20 @@
     "stellify",
     "ai",
     "code-generation",
-    "laravel"
+    "laravel",
+    "claude",
+    "anthropic"
   ],
-  "author": "Stellisoft",
+  "author": "Stellisoft <stellifysoftware@gmail.com> (https://stellisoft.com)",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Stellify-Software-Ltd/stellify-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Stellify-Software-Ltd/stellify-mcp/issues"
+  },
+  "homepage": "https://github.com/Stellify-Software-Ltd/stellify-mcp#readme",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.4",
     "axios": "^1.7.9",