@kasarlabs/cairo-coder-mcp 0.1.0 → 0.1.1

package/README.md

@@ -1,8 +1,8 @@
 <div align="center">
   <img src="./cairo-grey.png" alt="Cairo Coder MCP Logo" width="300"/>
   
-  [![npm version](https://img.shields.io/npm/v/@kasarlabs/cairo-coder-api.svg)](https://www.npmjs.com/package/@kasarlabs/cairo-coder-api)
-  [![npm downloads](https://img.shields.io/npm/dm/@kasarlabs/cairo-coder-api.svg)](https://www.npmjs.com/package/@kasarlabs/cairo-coder-api)
+  [![npm version](https://img.shields.io/npm/v/@kasarlabs/cairo-coder-mcp.svg)](https://www.npmjs.com/package/@kasarlabs/cairo-coder-mcp)
+  [![npm downloads](https://img.shields.io/npm/dm/@kasarlabs/cairo-coder-mcp.svg)](https://www.npmjs.com/package/@kasarlabs/cairo-coder-mcp)
   [![GitHub stars](https://img.shields.io/github/stars/kasarlabs/cairo-coder-mcp.svg)](https://github.com/kasarlabs/cairo-coder-mcp/stargazers)
   [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 </div>
@@ -16,25 +16,29 @@ A Model Context Protocol (MCP) server for Cairo and Starknet development assista
 Use this MCP server directly with npx:
 
 ```bash
-npx -y @kasarlabs/cairo-coder-api
+npx -y @kasarlabs/cairo-coder-mcp
 ```
 
 ## Configuration
 
-### Environment Variables
+The server supports two modes of operation:
 
-- `CAIRO_CODER_API_KEY`: Your Cairo Coder API key (required)
+### Mode 1: Public Cairo Coder API (Default)
+
+Use the official Cairo Coder API with your API key.
+
+**Environment Variables:**
 
-### Claude Desktop Setup
+- `CAIRO_CODER_API_KEY`: Your Cairo Coder API key (required)
 
-Add this configuration to your `claude_desktop_config.json`:
+**MCP Client Setup:**
 
 ```json
 {
   "mcpServers": {
     "cairo-coder": {
       "command": "npx",
-      "args": ["-y", "@kasarlabs/cairo-coder-api"],
+      "args": ["-y", "@kasarlabs/cairo-coder-mcp"],
       "env": {
         "CAIRO_CODER_API_KEY": "your-api-key-here"
       }
@@ -43,6 +47,32 @@ Add this configuration to your `claude_desktop_config.json`:
 }
 ```
 
+### Mode 2: Local/Custom Endpoint
+
+Use a local or custom Cairo Coder API endpoint (no API key required).
+
+**Environment Variables:**
+
+- `CAIRO_CODER_API_ENDPOINT`: Your local endpoint URL (e.g., "http://localhost:8000")
+
+**MCP Client Setup:**
+
+```json
+{
+  "mcpServers": {
+    "cairo-coder": {
+      "command": "npx",
+      "args": ["-y", "@kasarlabs/cairo-coder-mcp"],
+      "env": {
+        "CAIRO_CODER_API_ENDPOINT": "http://localhost:8000"
+      }
+    }
+  }
+}
+```
+
+> **Note:** When using `CAIRO_CODER_API_ENDPOINT`, the server automatically switches to local mode and no API key is required or used.
+
 ## Available Tools
 
 ### assist_with_cairo
@@ -94,7 +124,7 @@ Get help with Cairo and Starknet development tasks.
 
 ```bash
 git clone <repository-url>
-cd cairo-coder-api
+cd cairo-coder-mcp
 npm install
 ```
 
@@ -114,7 +144,7 @@ MIT
 
 For issues and questions:
 
-- GitHub Issues: [Create an issue](https://github.com/kasarlabs/cairo-coder-api/issues)
+- GitHub Issues: [Create an issue](https://github.com/kasarlabs/cairo-coder-mcp/issues)
 - MCP Documentation: [Model Context Protocol](https://modelcontextprotocol.io/)
 
 ## Contributing

package/dist/index.js

@@ -19,7 +19,7 @@ class CairoCoderMCPServer {
      */
     constructor() {
         this.server = new Server({
-            name: "cairo-coder-api",
+            name: "cairo-coder-mcp",
             version: "1.0.0",
             capabilities: {
                 tools: {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kasarlabs/cairo-coder-mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "MCP server to interact with the Cairo Coder API",
   "type": "module",
   "main": "dist/index.js",
@@ -11,7 +11,7 @@
     }
   },
   "bin": {
-    "cairo-coder-api": "./dist/index.js"
+    "cairo-coder-mcp": "./dist/index.js"
   },
   "files": [
     "dist",