Merge branch 'main' into main

Author: QuantGeekDev

.cursor/rules/mcp-framework.mdc

@@ -29,3 +29,86 @@ Servers offer any of the following features to clients:
 Resources: Context and data, for the user or the AI model to use
 Prompts: Templated messages and workflows for users
 Tools: Functions for the AI model to execute</specification>
+
+Here is an example of how a user creats an mcp server using mcp-framework as the library: <example>## src/tools/ExampleTool.ts
+
+```ts
+import { MCPTool } from "mcp-framework";
+import { z } from "zod";
+
+interface ExampleInput {
+  message: string;
+}
+
+class ExampleTool extends MCPTool<ExampleInput> {
+  name = "example_tool";
+  description = "An example tool that processes messages";
+
+  schema = {
+    message: {
+      type: z.string(),
+      description: "Message to process",
+    },
+  };
+
+  async execute(input: ExampleInput) {
+    return `Processed: ${input.message}`;
+  }
+}
+
+export default ExampleTool;
+```
+
+## src/index.ts
+
+```ts
+import { MCPServer } from "mcp-framework";
+
+const server = new MCPServer({transport:{
+  type:"http-stream",
+  options:{
+    port:1337,
+    cors: {
+      allowOrigin:"*"
+    }
+  }
+}});
+
+server.start();
+
+```
+
+## package.json
+
+```json
+{
+  "name": "http2-hi",
+  "version": "0.0.1",
+  "description": "http2-hi MCP server",
+  "type": "module",
+  "bin": {
+    "http2-hi": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && mcp-build",
+    "watch": "tsc --watch",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "mcp-framework": "^0.2.12-beta.4",
+    "zod": "^3.24.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.24",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.19.0"
+  }
+}
+
+```
+</example>

.gitignore

@@ -5,4 +5,3 @@ README
 .DS_Store
 dist
 node_modules
-.cursor

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.2.11"
+  ".": "0.2.13"
 }

CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.13](https://github.com/QuantGeekDev/mcp-framework/compare/mcp-framework-v0.2.12...mcp-framework-v0.2.13) (2025-05-23)
+
+
+### Bug Fixes
+
+* properly support required/optional tool input schema ([1583603](https://github.com/QuantGeekDev/mcp-framework/commit/1583603b2613b8c7c57ebbd52fb5c8159d0b8d13))
+
+## [0.2.12](https://github.com/QuantGeekDev/mcp-framework/compare/mcp-framework-v0.2.11...mcp-framework-v0.2.12) (2025-05-23)
+
+
+### Features
+
+* bump mcp ts sdk version ([d9cc845](https://github.com/QuantGeekDev/mcp-framework/commit/d9cc8450d39e89f36e39e78bb4d1946cf5f858d3))
+* enhanced cursor rule with example ([d3b54d4](https://github.com/QuantGeekDev/mcp-framework/commit/d3b54d4619e669ad322484b074a82aae27d61ae9))
+* replace custom implementation with sdk delegation ([1b5b8e7](https://github.com/QuantGeekDev/mcp-framework/commit/1b5b8e7cbe354056856a565b21b8908eb93ac2ba))
+
 ## [0.2.11](https://github.com/QuantGeekDev/mcp-framework/compare/mcp-framework-v0.2.10...mcp-framework-v0.2.11) (2025-03-30)
 
 

README.md

@@ -13,6 +13,15 @@ MCP-Framework gives you architecture out of the box, with automatic directory-ba
 - Easy-to-use base classes for tools, prompts, and resources
 - Out of the box authentication for SSE endpoints
 
+## Projects Built with MCP Framework
+
+The following projects and services are built using MCP Framework:
+
+- ### [tip.md](https://tip.md)
+A crypto tipping service that enables AI assistants to help users send cryptocurrency tips to content creators directly from their chat interface. The MCP service allows for:
+ - Checking wallet types for users
+ - Preparing cryptocurrency tips for users/agents to complete
+Setup instructions for various clients (Cursor, Sage, Claude Desktop) are available in their [MCP Server documentation](https://docs.tip.md/mcp-server/).
 
 # [Read the full docs here](https://mcp-framework.com)
 
@@ -417,6 +426,9 @@ class CustomAuthProvider implements AuthProvider {
   }
 }
 ```
+## Support our work
+
+[![Tip in Crypto](https://tip.md/badge.svg)](https://tip.md/tipdotmd)
 
 ## License
 

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-framework",
-  "version": "0.2.11",
+  "version": "0.2.13",
   "description": "Framework for building Model Context Protocol (MCP) servers in Typescript",
   "type": "module",
   "author": "Alex Andru <[email protected]>",
@@ -26,6 +26,7 @@
     "lint:fix": "eslint --fix",
     "format": "prettier --write \"src/**/*.ts\"",
     "prepare": "npm run build"
+    "dev:pub": "rm -rf dist && npm run build && yalc publish --push"
   },
   "engines": {
     "node": ">=18.19.0"
@@ -43,7 +44,7 @@
     "protocol"
   ],
   "peerDependencies": {
-    "@modelcontextprotocol/sdk": "1.8"
+    "@modelcontextprotocol/sdk": "^1.11.0"
   },
   "dependencies": {
     "@types/prompts": "^2.4.9",