init repo

Author: vcart

.gitignore

@@ -0,0 +1,56 @@
+# Dependency directories
+node_modules/
+.pnp/
+.pnp.js
+
+# Lock files
+# Uncomment the next line if you want to ignore package-lock.json
+# package-lock.json
+yarn.lock
+pnpm-lock.yaml
+bun.lock
+
+# Build outputs
+build/
+dist/
+out/
+
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# Environment variables
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Editor directories and files
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Testing
+coverage/
+.nyc_output/
+
+# Temporary files
+.tmp/
+.temp/
+tmp/
+temp/
+
+# npm package files
+*.tgz
+.npmrc
+
+# Cursor specific
+.cursor/

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Context Labs, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,117 @@
+# @mcpdotdirect/create-mcp-server
+
+![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)
+![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-3178C6)
+![MCP](https://img.shields.io/badge/MCP-1.6+-green)
+
+A CLI tool to create a new Model Context Protocol (MCP) server project. This package provides a template for building custom MCP servers that can be used by AI agents to interact with external systems and data sources.
+
+## 📋 Usage
+
+You can create a new MCP server project using npx:
+
+```bash
+# Create a new MCP server in the current directory
+npx @mcpdotdirect/create-mcp-server
+
+# Or with npm
+npm init @mcpdotdirect/create-mcp-server
+```
+
+This will create a new MCP server project in the current directory with all the necessary files. You'll need to install the dependencies manually after creation.
+
+## 🔭 What's Included
+
+The template includes:
+
+- Basic server setup with both stdio and HTTP transport options
+- Structure for defining MCP tools, resources, and prompts
+- TypeScript configuration
+- Development scripts and configuration
+
+## ✨ Features
+
+- **Dual Transport Support**: Run your MCP server over stdio or HTTP
+- **TypeScript**: Full TypeScript support for type safety
+- **MCP SDK**: Built on the official Model Context Protocol SDK
+- **Extensible**: Easy to add custom tools, resources, and prompts
+
+## 🚀 Getting Started
+
+After creating your project:
+
+1. Install dependencies using your preferred package manager:
+   ```bash
+   # Using npm
+   npm install
+   
+   # Using yarn
+   yarn
+   
+   # Using pnpm
+   pnpm install
+   
+   # Using bun
+   bun install
+   ```
+
+2. Start the server:
+   ```bash
+   # Start the stdio server
+   npm start
+   
+   # Or start the HTTP server
+   npm run start:http
+   ```
+
+3. For development with auto-reload:
+   ```bash
+   # Development mode with stdio
+   npm run dev
+   
+   # Development mode with HTTP
+   npm run dev:http
+   ```
+
+> **Note**: The default scripts in package.json use Bun as the runtime (e.g., `bun run src/index.ts`). If you prefer to use a different package manager or runtime, you can modify these scripts in your package.json file to use Node.js or another runtime of your choice.
+
+## 🛠️ Adding Custom Tools and Resources
+
+When adding custom tools, resources, or prompts to your MCP server:
+
+1. Use underscores (`_`) instead of hyphens (`-`) in all resource, tool, and prompt names
+   ```typescript
+   // Good: Uses underscores
+   server.tool(
+     "my_custom_tool",
+     "Description of my custom tool",
+     {
+       param_name: z.string().describe("Parameter description")
+     },
+     async (params) => {
+       // Tool implementation
+     }
+   );
+   
+   // Bad: Uses hyphens, may cause issues with Cursor
+   server.tool(
+     "my-custom-tool",
+     "Description of my custom tool",
+     {
+       param-name: z.string().describe("Parameter description")
+     },
+     async (params) => {
+       // Tool implementation
+     }
+   );
+   ```
+
+2. This naming convention ensures compatibility with Cursor and other AI tools that interact with your MCP server
+
+## 📚 Documentation
+
+For more information about the Model Context Protocol, visit the [MCP Documentation](https://modelcontextprotocol.io/introduction).
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

package.json

@@ -0,0 +1,31 @@
+{
+  "name": "mcp-server",
+  "module": "src/index.ts",
+  "type": "module",
+  "version": "1.0.0",
+  "description": "Model Context Protocol (MCP) Server",
+  "private": true,
+  "scripts": {
+    "start": "bun run src/index.ts",
+    "build": "bun build src/index.ts --outdir build --target node",
+    "build:http": "bun build src/server/http-server.ts --outdir build --target node",
+    "dev": "bun --watch src/index.ts",
+    "start:http": "bun run src/server/http-server.ts",
+    "dev:http": "bun --watch src/server/http-server.ts"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/cors": "^2.8.17",
+    "@types/express": "^5.0.0",
+    "@types/node": "^20.11.0"
+  },
+  "peerDependencies": {
+    "typescript": "^5.8.2"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.6.1",
+    "cors": "^2.8.5",
+    "express": "^4.21.2",
+    "zod": "^3.24.2"
+  }
+}

src/core/prompts.ts

@@ -0,0 +1,26 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+
+/**
+ * Register all prompts with the MCP server
+ * @param server The MCP server instance
+ */
+export function registerPrompts(server: McpServer) {
+  // Example prompt
+  server.prompt(
+    "greeting",
+    "A simple greeting prompt",
+    {
+      name: z.string().describe("Name to greet")
+    },
+    (params: { name: string }) => ({
+      messages: [{
+        role: "user",
+        content: {
+          type: "text",
+          text: `Hello, ${params.name}! How can I help you today?`
+        }
+      }]
+    })
+  );
+}

src/core/resources.ts

@@ -0,0 +1,23 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import * as services from "./services/index.js";
+
+/**
+ * Register all resources with the MCP server
+ * @param server The MCP server instance
+ */
+export function registerResources(server: McpServer) {
+  // Example resource
+  server.resource(
+    "example_resource", 
+    "example://{id}",
+    async (uri: URL) => {
+      const id = uri.pathname.split('/').pop();
+      return {
+        contents: [{
+          uri: uri.toString(),
+          text: `This is an example resource with ID: ${id}`
+        }]
+      };
+    }
+  );
+} 

src/core/services/greeting-service.ts

@@ -0,0 +1,22 @@
+/**
+ * A simple service for generating greetings
+ */
+export class GreetingService {
+  /**
+   * Generate a greeting message
+   * @param name The name to greet
+   * @returns A greeting message
+   */
+  public static generateGreeting(name: string): string {
+    return `Hello, ${name}! Welcome to the MCP Server.`;
+  }
+
+  /**
+   * Generate a farewell message
+   * @param name The name to bid farewell to
+   * @returns A farewell message
+   */
+  public static generateFarewell(name: string): string {
+    return `Goodbye, ${name}! Thank you for using the MCP Server.`;
+  }
+} 

src/core/services/index.ts

@@ -0,0 +1,2 @@
+// Export all services
+export * from './greeting-service.js';

src/core/tools.ts

@@ -0,0 +1,50 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import * as services from "./services/index.js";
+
+/**
+ * Register all tools with the MCP server
+ * 
+ * @param server The MCP server instance
+ */
+export function registerTools(server: McpServer) {
+  // Greeting tool
+  server.tool(
+    "hello_world",
+    "A simple hello world tool",
+    {
+      name: z.string().describe("Name to greet")
+    },
+    async (params: { name: string }) => {
+      const greeting = services.GreetingService.generateGreeting(params.name);
+      return {
+        content: [
+          {
+            type: "text",
+            text: greeting
+          }
+        ]
+      };
+    }
+  );
+
+  // Farewell tool
+  server.tool(
+    "goodbye",
+    "A simple goodbye tool",
+    {
+      name: z.string().describe("Name to bid farewell to")
+    },
+    async (params: { name: string }) => {
+      const farewell = services.GreetingService.generateFarewell(params.name);
+      return {
+        content: [
+          {
+            type: "text",
+            text: farewell
+          }
+        ]
+      };
+    }
+  );
+}

src/index.ts

@@ -0,0 +1,20 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import startServer from "./server/server.js";
+
+// Start the server
+async function main() {
+  try {
+    const server = await startServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("MCP Server running on stdio");
+  } catch (error) {
+    console.error("Error starting MCP server:", error);
+    process.exit(1);
+  }
+}
+
+main().catch((error) => {
+  console.error("Fatal error in main():", error);
+  process.exit(1);
+});