full MCP server from gmaison

.eslintrc.json

@@ -0,0 +1,19 @@
+{
+  "parser": "@typescript-eslint/parser",
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended",
+    "prettier"
+  ],
+  "plugins": ["@typescript-eslint"],
+  "parserOptions": {
+    "ecmaVersion": 2020,
+    "sourceType": "module"
+  },
+  "rules": {
+    "no-console": ["warn", { "allow": ["error", "warn"] }],
+    "@typescript-eslint/explicit-function-return-type": "off",
+    "@typescript-eslint/no-explicit-any": "off",
+    "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }]
+  }
+}

.gitignore

@@ -1,3 +1,4 @@
 node_modules
 .env
 build/
+**/.DS_Store

.prettierrc.json

@@ -0,0 +1,9 @@
+{
+  "semi": true,
+  "singleQuote": false,
+  "tabWidth": 2,
+  "printWidth": 100,
+  "trailingComma": "es5",
+  "bracketSpacing": true,
+  "arrowParens": "avoid"
+}

CLAUDE.md

@@ -0,0 +1,74 @@
+# CLAUDE.md for xano-mcp
+
+## Build/Test Commands
+- Build project: `npm run build`
+- Full build with lint & format: `npx eslint --fix src/**/*.ts && npx prettier --write src/**/*.ts && npm run build`
+- Start server: `npm run start`
+- Run TypeScript check: `npx tsc --noEmit`
+- Install dependencies: `npm install`
+- Lint project: `npx eslint --max-warnings=0 --ext .ts src/`
+- Fix lint issues: `npx eslint --fix src/**/*.ts`
+- Format code: `npx prettier --write "src/**/*.{ts,js,json}"`
+- Check formatting: `npx prettier --check "src/**/*.{ts,js,json}"`
+
+## Code Style Guidelines
+- **Imports**: Use ES modules (import/export) with .js extension for Node.js compatibility
+- **TypeScript**: Strict type checking; use interfaces for complex types
+- **Error Handling**: Use try/catch blocks with specific error messages
+- **Logging**: Use console.error for diagnostics (server logs)
+- **Environment**: Required variables: XANO_API_KEY, XANO_WORKSPACE, XANO_API_BASE
+- **Formatting**: 2-space indentation, semicolons required
+- **Naming**: camelCase for variables/functions, PascalCase for interfaces/types
+- **API Style**: Use zod for schema validation in tool definitions
+- **Documentation**: Include descriptions for all tool parameters
+- **Type Safety**: Prefer typed responses from API calls using generics
+
+## ESLint & Prettier Setup (Recommended)
+- Install: `npm i -D eslint prettier @typescript-eslint/parser @typescript-eslint/eslint-plugin eslint-config-prettier`
+- `.eslintrc.json`:
+```json
+{
+  "parser": "@typescript-eslint/parser",
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended",
+    "prettier"
+  ],
+  "plugins": ["@typescript-eslint"],
+  "parserOptions": {
+    "ecmaVersion": 2020,
+    "sourceType": "module"
+  },
+  "rules": {
+    "no-console": ["warn", { "allow": ["error", "warn"] }],
+    "@typescript-eslint/explicit-function-return-type": "off",
+    "@typescript-eslint/no-explicit-any": "warn"
+  }
+}
+```
+- `.prettierrc.json`:
+```json
+{
+  "semi": true,
+  "singleQuote": false,
+  "tabWidth": 2,
+  "printWidth": 100,
+  "trailingComma": "es5",
+  "bracketSpacing": true,
+  "arrowParens": "avoid"
+}
+```
+- Add to package.json scripts:
+```json
+"scripts": {
+  "build": "tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"",
+  "start": "node build/index.js",
+  "lint": "eslint --max-warnings=0 --ext .ts src/",
+  "lint:fix": "eslint --fix src/**/*.ts",
+  "format": "prettier --write \"src/**/*.{ts,js,json}\"",
+  "format:check": "prettier --check \"src/**/*.{ts,js,json}\"",
+  "prebuild": "npm run lint:fix && npm run format"
+}
+```
+
+To re-enable delete-table functionality: uncomment the block in src/index.ts then rebuild.

README.md

@@ -7,16 +7,18 @@ A Model Context Protocol (MCP) server for interacting with Xano's metadata API.
 - **Manage Tables**: Create, list, and delete tables in your Xano database
 - **Schema Operations**: View and modify table schemas with comprehensive schema editing capabilities
 - **Database Management**: Complete toolset for interacting with your Xano database structure
-- **Swagger Spec**: Extract your API group api details in either JSON or Markdown (reduced token) format
+- **API Management**: Create and manage API groups and individual APIs
+- **Swagger Spec**: Extract your API group details in either JSON or Markdown format
+- **39 Tools**: Complete implementation of 39 tools for managing your Xano workspace
 
-Note this is an early-stage with feedback / requests welcomed.
+Note: This is an early-stage project with feedback and requests welcomed.
 
 ## Prerequisites
 
 - Node.js (v16 or higher)
 - npm or another Node.js package manager
 - A Xano account with API access
-- Cursor, Claude Desktop, Cline or another MCP client.
+- Cursor, Claude Desktop, Cline or another MCP client
 
 ## Installation
 
@@ -31,11 +33,14 @@ cd xano-mcp
 npm install
 ```
 
-3. Configure your Xano credentials:
-   - Edit `index.ts` and set your Xano credentials:
-     - `XANO_API_KEY`: Your Xano API key
-     - `XANO_WORKSPACE`: Your Xano workspace ID
-     - `XANO_API_BASE`: Your Xano instance API URL (e.g., https://your-instance.xano.io/api:meta)
+3. Configure your Xano credentials by creating a `.env` file in the root directory with the following variables:
+```
+XANO_API_KEY=your_api_key_here
+XANO_WORKSPACE=your_workspace_id_here
+XANO_API_BASE=your_xano_instance_api_url_here
+```
+
+Example for XANO_API_BASE: `https://your-instance.xano.io/api:meta`
 
 4. Build the project:
 ```bash
@@ -44,7 +49,7 @@ npm run build
 
 ## Usage with Claude Desktop
 
-Follow this guide - https://modelcontextprotocol.io/quickstart/user
+Follow this guide: https://modelcontextprotocol.io/quickstart/user
 
 Update your config with: 
 ```json
@@ -53,7 +58,7 @@ Update your config with:
     "xano": {
       "command": "node",
       "args": [
-        "/path/to/xano-mcp"
+        "/path/to/xano-mcp/build/index.js"
       ]
     }
   }
@@ -62,7 +67,7 @@ Update your config with:
 
 Replace `/path/to/xano-mcp` with the absolute path to your project directory.
 
-**This does not work with the claude web app, only via the desktop app - https://claude.ai/download**
+**This works only with the Claude desktop app - https://claude.ai/download**
 
 ## Usage with Cursor
 
@@ -75,52 +80,86 @@ Replace `/path/to/xano-mcp` with the absolute path to your project directory.
 
 Replace `/path/to/xano-mcp` with the absolute path to your project directory.
 
-Example mac  
-node /Users/your-user/Documents/folder-name/xano-mcp/build/index.js
+Example for macOS:  
+`node /Users/your-user/Documents/folder-name/xano-mcp/build/index.js`
+
+If you're inside your directory, you can run the command `pwd` in your terminal to get the absolute path.
+
+## Environment Configuration
+
+The following environment variables are required:
+
+- `XANO_API_KEY`: Your Xano API key
+- `XANO_WORKSPACE`: Your Xano workspace ID
+- `XANO_API_BASE`: Your Xano instance API URL
+
+These can be set in a `.env` file in the root directory or through your system's environment variables.
+
+## Development and Maintenance
 
-If you're in your're inside your directory you can run the comman 'pwd' into your terminal to get the absolute path.
+This project includes several npm scripts to help with development:
+
+```bash
+# Build the project
+npm run build
+
+# Start the server
+npm run start
+
+# Lint the code
+npm run lint
+
+# Fix linting issues
+npm run lint:fix
+
+# Format code with Prettier
+npm run format
+
+# Check formatting
+npm run format:check
+```
 
 ## Xano MCP Tools Overview
 
 This integration provides a comprehensive set of tools for managing your Xano workspace through the Model Context Protocol (MCP). Here's what you can do:
 
-## Database Management
+### Database Management
 
-### Tables
+#### Tables
 - List all tables in your workspace
 - View detailed table schemas
 - Create new tables with custom schemas
-- Delete existing tables
+- Delete existing tables (disabled by default)
 - Modify table schemas (add/remove/rename columns)
 
-### Schema Operations
+#### Schema Operations
 - Add new columns with various data types
 - Remove columns
 - Rename columns
 - Update entire table schemas
 - Support for complex data types and relationships
 
-## API Management
+### API Management
 
-### API Groups
+#### API Groups
 - Create new API groups
 - List all API groups
 - Browse APIs within groups
 - Enable/disable Swagger documentation
 - Manage API group metadata (tags, branches, etc.)
 
-### Individual APIs
+#### Individual APIs
 - Add new APIs to groups
 - Configure HTTP methods (GET, POST, PUT, DELETE, PATCH, HEAD)
 - Set up API documentation
 - Add metadata (tags, descriptions)
 
-## Documentation
-- Generate API Group specifications in both markdown (reduced tokens) and JSO (full) formats
+### Documentation
+- Generate API Group specifications in both markdown (reduced tokens) and JSON (full) formats
 - View Swagger documentation
 - Access detailed schema information
 
-This toolset enables complete management of your Xano workspace, allowing you to build and maintain your backend infrastructure programmatically through the MCP interface. 
+This toolset enables complete management of your Xano workspace, allowing you to build and maintain your backend infrastructure programmatically through the MCP interface.
 
 ## Re-enabling the Delete Table Tool
 
@@ -143,7 +182,7 @@ To re-enable the delete-table functionality in this codebase, follow these step-
    - Delete the opening `/*` on the line after "Delete Table Tool"
    - Delete the closing `*/` before "Edit Table Schema Tool"
 
-   That's it! The delete-table tool will now be active again.   (After running a new build)
+   That's it! The delete-table tool will now be active again (after running a new build).
 
 ### Example of What the Code Should Look Like After
 
@@ -164,9 +203,9 @@ server.tool(
 ### Verification
 After making these changes:
 1. Save the file
-2. Run a new build `npm run build'
+2. Run a new build: `npm run build`
 3. Restart your MCP client (Claude / Cursor)
 4. The delete-table tool should now be available in your toolset
 
 ### Safety Note
-The delete-table tool permanently removes tables from your Xano workspace. Make sure you have appropriate backups before using this functionality. 
+The delete-table tool permanently removes tables from your Xano workspace. Make sure you have appropriate backups before using this functionality.