@nodusapi/mcp-server 1.0.0

package/dist/utils/validation.d.ts

@@ -0,0 +1,168 @@
+import { z } from 'zod';
+export declare const ListRowsSchema: z.ZodObject<{
+    tableSlug: z.ZodString;
+    page: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    orderBy: z.ZodOptional<z.ZodString>;
+    orderDir: z.ZodOptional<z.ZodEnum<["ASC", "DESC"]>>;
+    filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, "strip", z.ZodTypeAny, {
+    tableSlug: string;
+    page?: number | undefined;
+    limit?: number | undefined;
+    orderBy?: string | undefined;
+    orderDir?: "ASC" | "DESC" | undefined;
+    filters?: Record<string, any> | undefined;
+}, {
+    tableSlug: string;
+    page?: number | undefined;
+    limit?: number | undefined;
+    orderBy?: string | undefined;
+    orderDir?: "ASC" | "DESC" | undefined;
+    filters?: Record<string, any> | undefined;
+}>;
+export declare const GetRowSchema: z.ZodObject<{
+    tableSlug: z.ZodString;
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    tableSlug: string;
+}, {
+    id: string;
+    tableSlug: string;
+}>;
+export declare const CreateRowSchema: z.ZodObject<{
+    tableSlug: z.ZodString;
+    data: z.ZodRecord<z.ZodString, z.ZodAny>;
+}, "strip", z.ZodTypeAny, {
+    data: Record<string, any>;
+    tableSlug: string;
+}, {
+    data: Record<string, any>;
+    tableSlug: string;
+}>;
+export declare const UpdateRowSchema: z.ZodObject<{
+    tableSlug: z.ZodString;
+    id: z.ZodString;
+    data: z.ZodRecord<z.ZodString, z.ZodAny>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    data: Record<string, any>;
+    tableSlug: string;
+}, {
+    id: string;
+    data: Record<string, any>;
+    tableSlug: string;
+}>;
+export declare const DeleteRowSchema: z.ZodObject<{
+    tableSlug: z.ZodString;
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    tableSlug: string;
+}, {
+    id: string;
+    tableSlug: string;
+}>;
+export declare const ListTablesSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const GetTableSchemaSchema: z.ZodObject<{
+    tableSlug: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    tableSlug: string;
+}, {
+    tableSlug: string;
+}>;
+export declare const CreateTableSchema: z.ZodObject<{
+    name: z.ZodString;
+    slug: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    slug: string;
+    name: string;
+}, {
+    slug: string;
+    name: string;
+}>;
+export declare const UpdateTableSchema: z.ZodObject<{
+    tableSlug: z.ZodString;
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    tableSlug: string;
+}, {
+    name: string;
+    tableSlug: string;
+}>;
+export declare const AddColumnSchema: z.ZodObject<{
+    tableSlug: z.ZodString;
+    name: z.ZodString;
+    slug: z.ZodString;
+    type: z.ZodEnum<["string", "text", "integer", "float", "boolean", "datetime", "json"]>;
+    isRequired: z.ZodOptional<z.ZodBoolean>;
+    defaultValue: z.ZodOptional<z.ZodAny>;
+}, "strip", z.ZodTypeAny, {
+    slug: string;
+    type: "string" | "boolean" | "text" | "integer" | "float" | "datetime" | "json";
+    name: string;
+    tableSlug: string;
+    isRequired?: boolean | undefined;
+    defaultValue?: any;
+}, {
+    slug: string;
+    type: "string" | "boolean" | "text" | "integer" | "float" | "datetime" | "json";
+    name: string;
+    tableSlug: string;
+    isRequired?: boolean | undefined;
+    defaultValue?: any;
+}>;
+export declare const UpdateColumnSchema: z.ZodObject<{
+    tableSlug: z.ZodString;
+    columnSlug: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    isRequired: z.ZodOptional<z.ZodBoolean>;
+    defaultValue: z.ZodOptional<z.ZodAny>;
+}, "strip", z.ZodTypeAny, {
+    tableSlug: string;
+    columnSlug: string;
+    name?: string | undefined;
+    isRequired?: boolean | undefined;
+    defaultValue?: any;
+}, {
+    tableSlug: string;
+    columnSlug: string;
+    name?: string | undefined;
+    isRequired?: boolean | undefined;
+    defaultValue?: any;
+}>;
+export declare const ListProjectsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const CreateProjectSchema: z.ZodObject<{
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+}, {
+    name: string;
+}>;
+export declare const SwitchProjectSchema: z.ZodObject<{
+    projectId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+}, {
+    projectId: string;
+}>;
+export declare const ListApiKeysSchema: z.ZodObject<{
+    projectId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    projectId?: string | undefined;
+}, {
+    projectId?: string | undefined;
+}>;
+export declare const CreateApiKeySchema: z.ZodObject<{
+    projectId: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    projectId?: string | undefined;
+}, {
+    name: string;
+    projectId?: string | undefined;
+}>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;EAOzB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;EAGvB,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;EAG1B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;EAI1B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;EAG1B,CAAC;AAEH,eAAO,MAAM,gBAAgB,gDAAe,CAAC;AAE7C,eAAO,MAAM,oBAAoB;;;;;;EAE/B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;EAO1B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;EAM7B,CAAC;AAEH,eAAO,MAAM,kBAAkB,gDAAe,CAAC;AAE/C,eAAO,MAAM,mBAAmB;;;;;;EAE9B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;EAE9B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;EAE5B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;EAG7B,CAAC"}

package/dist/utils/validation.js

@@ -0,0 +1,68 @@
+import { z } from 'zod';
+export const ListRowsSchema = z.object({
+    tableSlug: z.string().min(1).describe('Table identifier (slug)'),
+    page: z.number().int().positive().default(1).optional().describe('Page number for pagination'),
+    limit: z.number().int().positive().max(100).default(20).optional().describe('Number of rows per page'),
+    orderBy: z.string().optional().describe('Column to order by'),
+    orderDir: z.enum(['ASC', 'DESC']).optional().describe('Sort direction'),
+    filters: z.record(z.any()).optional().describe('Filters to apply (column: value pairs)'),
+});
+export const GetRowSchema = z.object({
+    tableSlug: z.string().min(1).describe('Table identifier (slug)'),
+    id: z.string().uuid().describe('Row UUID'),
+});
+export const CreateRowSchema = z.object({
+    tableSlug: z.string().min(1).describe('Table identifier (slug)'),
+    data: z.record(z.any()).describe('Row data matching table schema'),
+});
+export const UpdateRowSchema = z.object({
+    tableSlug: z.string().min(1).describe('Table identifier (slug)'),
+    id: z.string().uuid().describe('Row UUID'),
+    data: z.record(z.any()).describe('Partial row data to update'),
+});
+export const DeleteRowSchema = z.object({
+    tableSlug: z.string().min(1).describe('Table identifier (slug)'),
+    id: z.string().uuid().describe('Row UUID to delete'),
+});
+export const ListTablesSchema = z.object({});
+export const GetTableSchemaSchema = z.object({
+    tableSlug: z.string().min(1).describe('Table identifier (slug)'),
+});
+export const CreateTableSchema = z.object({
+    name: z.string().min(1).max(255).describe('Human-readable table name'),
+    slug: z.string().min(1).max(255).regex(/^[a-z0-9_]+$/).describe('Table slug (lowercase, numbers, underscores only)'),
+});
+export const UpdateTableSchema = z.object({
+    tableSlug: z.string().min(1).describe('Current table slug'),
+    name: z.string().min(1).max(255).describe('New table name'),
+});
+export const AddColumnSchema = z.object({
+    tableSlug: z.string().min(1).describe('Table identifier (slug)'),
+    name: z.string().min(1).max(255).describe('Human-readable column name'),
+    slug: z.string().min(1).max(255).regex(/^[a-z0-9_]+$/).describe('Column slug (lowercase, numbers, underscores only)'),
+    type: z.enum(['string', 'text', 'integer', 'float', 'boolean', 'datetime', 'json']).describe('Column data type'),
+    isRequired: z.boolean().optional().describe('Whether the column is required'),
+    defaultValue: z.any().optional().describe('Default value for the column'),
+});
+export const UpdateColumnSchema = z.object({
+    tableSlug: z.string().min(1).describe('Table identifier (slug)'),
+    columnSlug: z.string().min(1).describe('Column identifier (slug)'),
+    name: z.string().min(1).max(255).optional().describe('New column name'),
+    isRequired: z.boolean().optional().describe('Whether the column is required'),
+    defaultValue: z.any().optional().describe('Default value for the column'),
+});
+export const ListProjectsSchema = z.object({});
+export const CreateProjectSchema = z.object({
+    name: z.string().min(1).max(255).describe('Project name'),
+});
+export const SwitchProjectSchema = z.object({
+    projectId: z.string().uuid().describe('Project UUID to switch to'),
+});
+export const ListApiKeysSchema = z.object({
+    projectId: z.string().uuid().optional().describe('Project UUID (optional, uses current project if not provided)'),
+});
+export const CreateApiKeySchema = z.object({
+    projectId: z.string().uuid().optional().describe('Project UUID (optional, uses current project if not provided)'),
+    name: z.string().min(1).max(255).describe('API key name'),
+});
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"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"}

package/docs/project-goal-mcp.md

@@ -0,0 +1,129 @@
+# Nodus MCP Server - Project Documentation
+
+## Project Goal
+
+This MCP server allows AI assistants (like Claude in Cursor) to interact directly with NodusAPI endpoints, enabling natural language database operations.
+
+## Architecture
+
+```
+User (Cursor/Claude)
+    ↓
+MCP Protocol (stdio)
+    ↓
+Nodus MCP Server
+    ↓
+NodusAPI Client (HTTP)
+    ↓
+NodusAPI Backend
+    ↓
+PostgreSQL Database
+```
+
+## Key Design Decisions
+
+### 1. Security First
+- No delete operations for tables/projects (only rows)
+- API key validation and masking
+- Comprehensive error handling
+- Input validation with Zod
+
+### 2. Hybrid Configuration
+- Environment variables (Cursor integration)
+- Interactive prompt (first-time setup)
+- Persistent config file (~/.nodus-mcp/config.json)
+
+### 3. Tool Categories
+- **Data Tools**: CRUD operations on table rows
+- **Schema Tools**: Table and column management
+- **Project Tools**: Project and API key management
+- **Resources**: Automatic schema context for LLM
+
+### 4. Error Handling
+- User-friendly error messages
+- Graceful API error handling
+- Network retry logic in client
+- Validation errors with context
+
+## File Structure
+
+```
+src/
+├── index.ts                    # Main entry point, MCP server setup
+├── config.ts                   # Configuration management
+├── client/
+│   ├── nodus-client.ts        # HTTP client wrapper for NodusAPI
+│   └── types.ts               # TypeScript interfaces
+├── tools/
+│   ├── data-tools.ts          # Data CRUD MCP tools
+│   ├── schema-tools.ts        # Schema management MCP tools
+│   └── project-tools.ts       # Project management MCP tools
+├── resources/
+│   └── schema-resources.ts    # MCP resources for table schemas
+└── utils/
+    ├── auth.ts                # Authentication helpers
+    └── validation.ts          # Zod validation schemas
+```
+
+## Development Notes
+
+### MCP Protocol
+- Uses stdio transport for local communication
+- Tools are discovered via ListToolsRequestSchema
+- Tools are invoked via CallToolRequestSchema
+- Resources provide contextual information to LLM
+
+### API Client
+- Axios-based HTTP client
+- Automatic error handling and formatting
+- Support for all NodusAPI endpoints
+- Query parameter building for filters/pagination
+
+### Validation
+- Zod schemas for all tool inputs
+- Type safety throughout the codebase
+- Runtime validation before API calls
+
+## Testing
+
+To test locally:
+
+1. Build: `npm run build`
+2. Set environment variables:
+   ```bash
+   export NODUS_API_KEY="nds_your_key"
+   export NODUS_PROJECT_ID="your_project_id"
+   ```
+3. Run: `npm start`
+4. Configure Cursor to use local server
+5. Test with natural language commands
+
+## Future Enhancements
+
+Potential improvements:
+- [ ] Caching for table schemas
+- [ ] Batch operations support
+- [ ] Webhook/event subscriptions
+- [ ] Advanced filtering DSL
+- [ ] Transaction support
+- [ ] Custom function execution
+- [ ] File upload/download support
+- [ ] Real-time data subscriptions
+
+## Publishing Checklist
+
+Before publishing to npm:
+1. ✅ Update version in package.json
+2. ✅ Ensure all tests pass
+3. ✅ Build successfully
+4. ✅ README is complete
+5. ✅ License file added
+6. ⬜ GitHub repository created
+7. ⬜ npm package published
+8. ⬜ MCP Registry submission
+
+## Related Documentation
+
+- [NodusAPI Documentation](../nodusapi/docs/)
+- [MCP Specification](https://modelcontextprotocol.io)
+- [TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)

package/docs/research/mcp-links.md

@@ -0,0 +1,2 @@
+https://modelcontextprotocol.io/docs/develop/build-server
+https://medium.com/data-science-collective/build-your-first-mcp-server-in-15-minutes-complete-code-d63f85c0ce79

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@nodusapi/mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for NodusAPI - Enable LLMs to interact with your BaaS backend",
+  "type": "module",
+  "bin": {
+    "nodus-mcp": "dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "nodus",
+    "nodusapi",
+    "baas",
+    "llm",
+    "ai",
+    "cursor",
+    "claude"
+  ],
+  "author": "Alperen Cenky <alprncnky@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nodusapi/nodusmcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/nodusapi/nodusmcp/issues"
+  },
+  "homepage": "https://github.com/nodusapi/nodusmcp#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "axios": "^1.6.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "mcpName": "io.github.nodusapi/nodus-mcp-server"
+}