[{"_1":2,"_332":-5,"_333":-5},"loaderData",{"_3":4,"_22":23,"_253":254},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"bot","id",22248096,"membership","referenceId","019a3c9b-43cc-72d8-8c00-496521d6e6ee","userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_24":25,"_67":-5,"_68":26,"_27":69,"_169":170,"_252":150},"availableLocales",[26,39,46,53,60],{"_27":28,"_35":36,"_37":38},"mcpServer",{"_29":30,"_31":32,"_33":34},"description","A TypeScript framework for building Model Context Protocol (MCP) servers with automatic discovery and loading of tools, resources, and prompts.","displayName","MCP Framework","readme","# MCP Framework\n\nA TypeScript framework for building Model Context Protocol (MCP) servers.\n\n## Changes from Original\n\nThis fork (@ronangrant/mcp-framework) includes the following improvements:\n- Replaced file-based logging with console-only logging for better compatibility and reliability\n- Removed dependency on filesystem for logs, eliminating ENOENT errors\n- Simplified logging implementation while maintaining the same interface\n- All logs now output to stderr via console.error()\n\n## Installation\n\n```bash\nnpm install @ronangrant/mcp-framework\n```\n\n## Usage\n\nCreate a new MCP server:\n\n```typescript\nimport { MCPServer } from '@ronangrant/mcp-framework';\n\nconst server = new MCPServer({\n name: \"my-server\",\n version: \"1.0.0\"\n});\n\nawait server.start();\n```\n\n## Features\n\n- Easy-to-use API for creating MCP servers\n- Built-in support for tools, prompts, and resources\n- Simplified logging system with console output\n- Full TypeScript support\n- Flexible transport options\n\n## License\n\nMIT\n\nMCP-Framework is a framework for building Model Context Protocol (MCP) servers elegantly in TypeScript.\n\nMCP-Framework gives you architecture out of the box, with automatic directory-based discovery for tools, resources, and prompts. Use our powerful MCP abstractions to define tools, resources, or prompts in an elegant way. Our cli makes getting started with your own MCP server a breeze\n\n## Features\n\n- 🛠️ Automatic discovery and loading of tools, resources, and prompts\n- Multiple transport support (stdio, SSE)\n- TypeScript-first development with full type safety\n- Built on the official MCP SDK\n- Easy-to-use base classes for tools, prompts, and resources\n- Out of the box authentication for SSE endpoints\n\n\n# [Read the full docs here](https://mcp-framework.com)\n\n\n\n\n\n## Creating a repository with mcp-framework\n\n### Using the CLI (Recommended)\n\n```bash\n# Install the framework globally\nnpm install -g mcp-framework\n\n# Create a new MCP server project\nmcp create my-mcp-server\n\n# Navigate to your project\ncd my-mcp-server\n\n# Your server is ready to use!\n```\n\n## CLI Usage\n\nThe framework provides a powerful CLI for managing your MCP server projects:\n\n### Project Creation\n\n```bash\n# Create a new project\nmcp create \n```\n\n### Adding a Tool\n\n```bash\n# Add a new tool\nmcp add tool price-fetcher\n```\n\n### Adding a Prompt\n\n```bash\n# Add a new prompt\nmcp add prompt price-analysis\n```\n\n### Adding a Resource\n\n```bash\n# Add a new prompt\nmcp add resource market-data\n```\n\n## Development Workflow\n\n1. Create your project:\n\n```bash\n mcp create my-mcp-server\n cd my-mcp-server\n```\n\n2. Add tools as needed:\n\n ```bash\n mcp add tool data-fetcher\n mcp add tool data-processor\n mcp add tool report-generator\n ```\n\n3. Build:\n\n ```bash\n npm run build\n\n ```\n\n4. Add to MCP Client (Read below for Claude Desktop example)\n\n## Using with Claude Desktop\n\n### Local Development\n\nAdd this configuration to your Claude Desktop config file:\n\n**MacOS**: \\`~/Library/Application Support/Claude/claude_desktop_config.json\\`\n**Windows**: \\`%APPDATA%/Claude/claude_desktop_config.json\\`\n\n```json\n{\n\"mcpServers\": {\n\"${projectName}\": {\n \"command\": \"node\",\n \"args\":[\"/absolute/path/to/${projectName}/dist/index.js\"]\n}\n}\n}\n```\n\n### After Publishing\n\nAdd this configuration to your Claude Desktop config file:\n\n**MacOS**: \\`~/Library/Application Support/Claude/claude_desktop_config.json\\`\n**Windows**: \\`%APPDATA%/Claude/claude_desktop_config.json\\`\n\n```json\n{\n\"mcpServers\": {\n\"${projectName}\": {\n \"command\": \"npx\",\n \"args\": [\"${projectName}\"]\n}\n}\n}\n```\n\n## Building and Testing\n\n1. Make changes to your tools\n2. Run \\`npm run build\\` to compile\n3. The server will automatically load your tools on startup\n\n## Quick Start\n\n### Creating a Tool\n\n```typescript\nimport { MCPTool } from \"mcp-framework\";\nimport { z } from \"zod\";\n\ninterface ExampleInput {\n message: string;\n}\n\nclass ExampleTool extends MCPTool {\n name = \"example_tool\";\n description = \"An example tool that processes messages\";\n\n schema = {\n message: {\n type: z.string(),\n description: \"Message to process\",\n },\n };\n\n async execute(input: ExampleInput) {\n return `Processed: ${input.message}`;\n }\n}\n\nexport default ExampleTool;\n```\n\n### Setting up the Server\n\n```typescript\nimport { MCPServer } from \"mcp-framework\";\n\nconst server = new MCPServer();\n\n// OR (mutually exclusive!) with SSE transport\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n port: 8080 // Optional (default: 8080)\n }\n }\n});\n\n// Start the server\nawait server.start();\n```\n\n## Transport Configuration\n\n### stdio Transport (Default)\n\nThe stdio transport is used by default if no transport configuration is provided:\n\n```typescript\nconst server = new MCPServer();\n// or explicitly:\nconst server = new MCPServer({\n transport: { type: \"stdio\" }\n});\n```\n\n### SSE Transport\n\nTo use Server-Sent Events (SSE) transport:\n\n```typescript\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n port: 8080, // Optional (default: 8080)\n endpoint: \"/sse\", // Optional (default: \"/sse\")\n messageEndpoint: \"/messages\", // Optional (default: \"/messages\")\n cors: {\n allowOrigin: \"*\", // Optional (default: \"*\")\n allowMethods: \"GET, POST, OPTIONS\", // Optional (default: \"GET, POST, OPTIONS\")\n allowHeaders: \"Content-Type, Authorization, x-api-key\", // Optional (default: \"Content-Type, Authorization, x-api-key\")\n exposeHeaders: \"Content-Type, Authorization, x-api-key\", // Optional (default: \"Content-Type, Authorization, x-api-key\")\n maxAge: \"86400\" // Optional (default: \"86400\")\n }\n }\n }\n});\n```\n\n#### CORS Configuration\n\nThe SSE transport supports flexible CORS configuration. By default, it uses permissive settings suitable for development. For production, you should configure CORS according to your security requirements:\n\n```typescript\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n // Restrict to specific origin\n cors: {\n allowOrigin: \"https://myapp.com\",\n allowMethods: \"GET, POST\",\n allowHeaders: \"Content-Type, Authorization\",\n exposeHeaders: \"Content-Type, Authorization\",\n maxAge: \"3600\"\n }\n }\n }\n});\n\n// Or with multiple allowed origins\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n cors: {\n allowOrigin: \"https://app1.com, https://app2.com\",\n allowMethods: \"GET, POST, OPTIONS\",\n allowHeaders: \"Content-Type, Authorization, Custom-Header\",\n exposeHeaders: \"Content-Type, Authorization\",\n maxAge: \"86400\"\n }\n }\n }\n});\n```\n\n## Authentication\n\nMCP Framework provides optional authentication for SSE endpoints. You can choose between JWT and API Key authentication, or implement your own custom authentication provider.\n\n### JWT Authentication\n\n```typescript\nimport { MCPServer, JWTAuthProvider } from \"mcp-framework\";\nimport { Algorithm } from \"jsonwebtoken\";\n\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n auth: {\n provider: new JWTAuthProvider({\n secret: process.env.JWT_SECRET,\n algorithms: [\"HS256\" as Algorithm], // Optional (default: [\"HS256\"])\n headerName: \"Authorization\" // Optional (default: \"Authorization\")\n }),\n endpoints: {\n sse: true, // Protect SSE endpoint (default: false)\n messages: true // Protect message endpoint (default: true)\n }\n }\n }\n }\n});\n```\n\nClients must include a valid JWT token in the Authorization header:\n```\nAuthorization: Bearer eyJhbGciOiJIUzI1NiIs...\n```\n\n### API Key Authentication\n\n```typescript\nimport { MCPServer, APIKeyAuthProvider } from \"mcp-framework\";\n\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n auth: {\n provider: new APIKeyAuthProvider({\n keys: [process.env.API_KEY],\n headerName: \"X-API-Key\" // Optional (default: \"X-API-Key\")\n })\n }\n }\n }\n});\n```\n\nClients must include a valid API key in the X-API-Key header:\n```\nX-API-Key: your-api-key\n```\n\n### Custom Authentication\n\nYou can implement your own authentication provider by implementing the `AuthProvider` interface:\n\n```typescript\nimport { AuthProvider, AuthResult } from \"mcp-framework\";\nimport { IncomingMessage } from \"node:http\";\n\nclass CustomAuthProvider implements AuthProvider {\n async authenticate(req: IncomingMessage): Promise {\n // Implement your custom authentication logic\n return true;\n }\n\n getAuthError() {\n return {\n status: 401,\n message: \"Authentication failed\"\n };\n }\n}\n```\n\n## License\n\nMIT\n","name","English","tag","en-US",{"_27":40,"_35":44,"_37":45},{"_29":41,"_31":42,"_33":43},"Un marco de TypeScript para crear servidores de Protocolo de Contexto de Modelo (MCP) con descubrimiento y carga automáticos de herramientas, recursos y avisos.","Marco MCP","# Marco MCP\n\nUn marco de TypeScript para crear servidores de Protocolo de Contexto de Modelo (MCP).\n\n## Cambios respecto al original\n\nEsta bifurcación (@ronangrant/mcp-framework) incluye las siguientes mejoras:\n\n* Se reemplazó el registro basado en archivos con un registro solo en la consola para lograr una mejor compatibilidad y confiabilidad.\n* Se eliminó la dependencia del sistema de archivos para los registros, eliminando así los errores ENOENT\n* Implementación de registro simplificada manteniendo la misma interfaz\n* Todos los registros ahora se envían a stderr a través de console.error()\n\n## Instalación\n\n```bash\nnpm install @ronangrant/mcp-framework\n```\n\n## Uso\n\nCrear un nuevo servidor MCP:\n\n```typescript\nimport { MCPServer } from '@ronangrant/mcp-framework';\n\nconst server = new MCPServer({\n name: \"my-server\",\n version: \"1.0.0\"\n});\n\nawait server.start();\n```\n\n## Características\n\n* API fácil de usar para crear servidores MCP\n* Soporte integrado para herramientas, indicaciones y recursos\n* Sistema de registro simplificado con salida de consola\n* Compatibilidad total con TypeScript\n* Opciones de transporte flexibles\n\n## Licencia\n\nInstituto Tecnológico de Massachusetts (MIT)\n\nMCP-Framework es un marco para construir servidores de Protocolo de Contexto de Modelo (MCP) de manera elegante en TypeScript.\n\nMCP-Framework le ofrece una arquitectura lista para usar, con descubrimiento automático basado en directorios para herramientas, recursos y solicitudes. Utilice nuestras potentes abstracciones de MCP para definir herramientas, recursos o solicitudes de forma elegante. Nuestra CLI facilita enormemente la creación de su propio servidor MCP.\n\n## Características\n\n* 🛠️ Descubrimiento y carga automáticos de herramientas, recursos y avisos\n* Compatibilidad con múltiples transportes (stdio, SSE)\n* Desarrollo basado en TypeScript con seguridad de tipos completa\n* Desarrollado sobre el SDK oficial de MCP\n* Clases base fáciles de usar para herramientas, indicaciones y recursos\n* Autenticación lista para usar para puntos finales de SSE\n\n# [Lea los documentos completos aquí](https://mcp-framework.com)\n\n## Creación de un repositorio con mcp-framework\n\n### Uso de la CLI (recomendado)\n\n```bash\n# Install the framework globally\nnpm install -g mcp-framework\n\n# Create a new MCP server project\nmcp create my-mcp-server\n\n# Navigate to your project\ncd my-mcp-server\n\n# Your server is ready to use!\n```\n\n## Uso de la CLI\n\nEl marco proporciona una potente CLI para administrar sus proyectos de servidor MCP:\n\n### Creación de proyectos\n\n```bash\n# Create a new project\nmcp create \n```\n\n### Agregar una herramienta\n\n```bash\n# Add a new tool\nmcp add tool price-fetcher\n```\n\n### Agregar un mensaje\n\n```bash\n# Add a new prompt\nmcp add prompt price-analysis\n```\n\n### Agregar un recurso\n\n```bash\n# Add a new prompt\nmcp add resource market-data\n```\n\n## Flujo de trabajo de desarrollo\n\n1. Crea tu proyecto:\n\n```bash\n mcp create my-mcp-server\n cd my-mcp-server\n```\n\n2. Agregue herramientas según sea necesario:\n\n ```bash\n mcp add tool data-fetcher\n mcp add tool data-processor\n mcp add tool report-generator\n ```\n\n3. Construir:\n\n ```bash\n npm run build\n\n ```\n\n4. Agregar al cliente MCP (lea a continuación el ejemplo de Claude Desktop)\n\n## Uso con Claude Desktop\n\n### Desarrollo local\n\nAgregue esta configuración a su archivo de configuración de Claude Desktop:\n\n**MacOS** : \\`~/Biblioteca/Soporte de aplicaciones/Claude/claude\\_desktop\\_config.json\\` **Windows** : \\`%APPDATA%/Claude/claude\\_desktop\\_config.json\\`\n\n```json\n{\n\"mcpServers\": {\n\"${projectName}\": {\n \"command\": \"node\",\n \"args\":[\"/absolute/path/to/${projectName}/dist/index.js\"]\n}\n}\n}\n```\n\n### Después de la publicación\n\nAgregue esta configuración a su archivo de configuración de Claude Desktop:\n\n**MacOS** : \\`~/Biblioteca/Soporte de aplicaciones/Claude/claude\\_desktop\\_config.json\\` **Windows** : \\`%APPDATA%/Claude/claude\\_desktop\\_config.json\\`\n\n```json\n{\n\"mcpServers\": {\n\"${projectName}\": {\n \"command\": \"npx\",\n \"args\": [\"${projectName}\"]\n}\n}\n}\n```\n\n## Construcción y pruebas\n\n1. Realizar cambios en sus herramientas\n2. Ejecute \\`npm run build\\` para compilar\n3. El servidor cargará automáticamente sus herramientas al iniciarse\n\n## Inicio rápido\n\n### Creando una herramienta\n\n```typescript\nimport { MCPTool } from \"mcp-framework\";\nimport { z } from \"zod\";\n\ninterface ExampleInput {\n message: string;\n}\n\nclass ExampleTool extends MCPTool {\n name = \"example_tool\";\n description = \"An example tool that processes messages\";\n\n schema = {\n message: {\n type: z.string(),\n description: \"Message to process\",\n },\n };\n\n async execute(input: ExampleInput) {\n return `Processed: ${input.message}`;\n }\n}\n\nexport default ExampleTool;\n```\n\n### Configuración del servidor\n\n```typescript\nimport { MCPServer } from \"mcp-framework\";\n\nconst server = new MCPServer();\n\n// OR (mutually exclusive!) with SSE transport\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n port: 8080 // Optional (default: 8080)\n }\n }\n});\n\n// Start the server\nawait server.start();\n```\n\n## Configuración de transporte\n\n### Transporte stdio (predeterminado)\n\nEl transporte stdio se utiliza de forma predeterminada si no se proporciona ninguna configuración de transporte:\n\n```typescript\nconst server = new MCPServer();\n// or explicitly:\nconst server = new MCPServer({\n transport: { type: \"stdio\" }\n});\n```\n\n### Transporte SSE\n\nPara utilizar el transporte de eventos enviados por el servidor (SSE):\n\n```typescript\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n port: 8080, // Optional (default: 8080)\n endpoint: \"/sse\", // Optional (default: \"/sse\")\n messageEndpoint: \"/messages\", // Optional (default: \"/messages\")\n cors: {\n allowOrigin: \"*\", // Optional (default: \"*\")\n allowMethods: \"GET, POST, OPTIONS\", // Optional (default: \"GET, POST, OPTIONS\")\n allowHeaders: \"Content-Type, Authorization, x-api-key\", // Optional (default: \"Content-Type, Authorization, x-api-key\")\n exposeHeaders: \"Content-Type, Authorization, x-api-key\", // Optional (default: \"Content-Type, Authorization, x-api-key\")\n maxAge: \"86400\" // Optional (default: \"86400\")\n }\n }\n }\n});\n```\n\n#### Configuración de CORS\n\nEl transporte SSE admite una configuración flexible de CORS. De forma predeterminada, utiliza configuraciones permisivas, adecuadas para el desarrollo. Para producción, debe configurar CORS según sus requisitos de seguridad:\n\n```typescript\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n // Restrict to specific origin\n cors: {\n allowOrigin: \"https://myapp.com\",\n allowMethods: \"GET, POST\",\n allowHeaders: \"Content-Type, Authorization\",\n exposeHeaders: \"Content-Type, Authorization\",\n maxAge: \"3600\"\n }\n }\n }\n});\n\n// Or with multiple allowed origins\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n cors: {\n allowOrigin: \"https://app1.com, https://app2.com\",\n allowMethods: \"GET, POST, OPTIONS\",\n allowHeaders: \"Content-Type, Authorization, Custom-Header\",\n exposeHeaders: \"Content-Type, Authorization\",\n maxAge: \"86400\"\n }\n }\n }\n});\n```\n\n## Autenticación\n\nEl marco MCP ofrece autenticación opcional para los endpoints SSE. Puede elegir entre autenticación mediante JWT y clave API, o implementar su propio proveedor de autenticación personalizado.\n\n### Autenticación JWT\n\n```typescript\nimport { MCPServer, JWTAuthProvider } from \"mcp-framework\";\nimport { Algorithm } from \"jsonwebtoken\";\n\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n auth: {\n provider: new JWTAuthProvider({\n secret: process.env.JWT_SECRET,\n algorithms: [\"HS256\" as Algorithm], // Optional (default: [\"HS256\"])\n headerName: \"Authorization\" // Optional (default: \"Authorization\")\n }),\n endpoints: {\n sse: true, // Protect SSE endpoint (default: false)\n messages: true // Protect message endpoint (default: true)\n }\n }\n }\n }\n});\n```\n\nLos clientes deben incluir un token JWT válido en el encabezado de autorización:\n\n```\nAuthorization: Bearer eyJhbGciOiJIUzI1NiIs...\n```\n\n### Autenticación de clave API\n\n```typescript\nimport { MCPServer, APIKeyAuthProvider } from \"mcp-framework\";\n\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n auth: {\n provider: new APIKeyAuthProvider({\n keys: [process.env.API_KEY],\n headerName: \"X-API-Key\" // Optional (default: \"X-API-Key\")\n })\n }\n }\n }\n});\n```\n\nLos clientes deben incluir una clave API válida en el encabezado X-API-Key:\n\n```\nX-API-Key: your-api-key\n```\n\n### Autenticación personalizada\n\nPuede implementar su propio proveedor de autenticación implementando la interfaz `AuthProvider` :\n\n```typescript\nimport { AuthProvider, AuthResult } from \"mcp-framework\";\nimport { IncomingMessage } from \"node:http\";\n\nclass CustomAuthProvider implements AuthProvider {\n async authenticate(req: IncomingMessage): Promise {\n // Implement your custom authentication logic\n return true;\n }\n\n getAuthError() {\n return {\n status: 401,\n message: \"Authentication failed\"\n };\n }\n}\n```\n\n## Licencia\n\nInstituto Tecnológico de Massachusetts (MIT)","Spanish","es-ES",{"_27":47,"_35":51,"_37":52},{"_29":48,"_31":49,"_33":50},"ツール、リソース、プロンプトを自動的に検出して読み込むモデルコンテキストプロトコル (MCP) サーバーを構築するための TypeScript フレームワーク。","MCPフレームワーク","# MCPフレームワーク\n\nモデルコンテキストプロトコル (MCP) サーバーを構築するための TypeScript フレームワーク。\n\n## オリジナルからの変更点\n\nこのフォーク (@ronangrant/mcp-framework) には、次の改善が含まれています。\n\n* 互換性と信頼性を向上させるために、ファイルベースのログ記録をコンソールのみのログ記録に置き換えました。\n* ログのファイルシステムへの依存をなくし、ENOENT エラーを排除しました\n* 同じインターフェースを維持しながら、ログの実装を簡素化\n* すべてのログが console.error() 経由で stderr に出力されるようになりました\n\n## インストール\n\n```bash\nnpm install @ronangrant/mcp-framework\n```\n\n## 使用法\n\n新しい MCP サーバーを作成します。\n\n```typescript\nimport { MCPServer } from '@ronangrant/mcp-framework';\n\nconst server = new MCPServer({\n name: \"my-server\",\n version: \"1.0.0\"\n});\n\nawait server.start();\n```\n\n## 特徴\n\n* MCP サーバーを作成するための使いやすい API\n* ツール、プロンプト、リソースの組み込みサポート\n* コンソール出力を備えた簡素化されたログシステム\n* 完全なTypeScriptサポート\n* 柔軟な輸送オプション\n\n## ライセンス\n\nマサチューセッツ工科大学\n\nMCP-Framework は、TypeScript でモデルコンテキストプロトコル (MCP) サーバーをエレガントに構築するためのフレームワークです。\n\nMCPフレームワークは、ツール、リソース、プロンプトをディレクトリベースで自動検出する機能を備え、すぐに使えるアーキテクチャを提供します。強力なMCP抽象化機能を使用して、ツール、リソース、プロンプトを洗練された方法で定義できます。CLIを使えば、独自のMCPサーバーを簡単に構築できます。\n\n## 特徴\n\n* 🛠️ ツール、リソース、プロンプトの自動検出と読み込み\n* 複数のトランスポートのサポート (stdio、SSE)\n* 完全な型安全性を備えた TypeScript ファースト開発\n* 公式MCP SDKをベースに構築\n* ツール、プロンプト、リソース用の使いやすい基本クラス\n* SSEエンドポイントのすぐに使える認証\n\n# [完全なドキュメントはこちらでご覧ください](https://mcp-framework.com)\n\n## mcp-framework でリポジトリを作成する\n\n### CLI の使用 (推奨)\n\n```bash\n# Install the framework globally\nnpm install -g mcp-framework\n\n# Create a new MCP server project\nmcp create my-mcp-server\n\n# Navigate to your project\ncd my-mcp-server\n\n# Your server is ready to use!\n```\n\n## CLI の使用法\n\nこのフレームワークは、MCP サーバープロジェクトを管理するための強力な CLI を提供します。\n\n### プロジェクトの作成\n\n```bash\n# Create a new project\nmcp create \n```\n\n### ツールの追加\n\n```bash\n# Add a new tool\nmcp add tool price-fetcher\n```\n\n### プロンプトの追加\n\n```bash\n# Add a new prompt\nmcp add prompt price-analysis\n```\n\n### リソースの追加\n\n```bash\n# Add a new prompt\nmcp add resource market-data\n```\n\n## 開発ワークフロー\n\n1. プロジェクトを作成します。\n\n```bash\n mcp create my-mcp-server\n cd my-mcp-server\n```\n\n2. 必要に応じてツールを追加します。\n\n ```bash\n mcp add tool data-fetcher\n mcp add tool data-processor\n mcp add tool report-generator\n ```\n\n3. 建てる：\n\n ```bash\n npm run build\n\n ```\n\n4. MCP クライアントに追加 (Claude Desktop の例については以下を参照してください)\n\n## Claude Desktopでの使用\n\n### 地域開発\n\nこの構成を Claude Desktop 構成ファイルに追加します。\n\n**MacOS** : \\`~/Library/Application Support/Claude/claude\\_desktop\\_config.json\\` **Windows** : \\`%APPDATA%/Claude/claude\\_desktop\\_config.json\\`\n\n```json\n{\n\"mcpServers\": {\n\"${projectName}\": {\n \"command\": \"node\",\n \"args\":[\"/absolute/path/to/${projectName}/dist/index.js\"]\n}\n}\n}\n```\n\n### 公開後\n\nこの構成を Claude Desktop 構成ファイルに追加します。\n\n**MacOS** : \\`~/Library/Application Support/Claude/claude\\_desktop\\_config.json\\` **Windows** : \\`%APPDATA%/Claude/claude\\_desktop\\_config.json\\`\n\n```json\n{\n\"mcpServers\": {\n\"${projectName}\": {\n \"command\": \"npx\",\n \"args\": [\"${projectName}\"]\n}\n}\n}\n```\n\n## 構築とテスト\n\n1. ツールに変更を加える\n2. \\`npm run build\\` を実行してコンパイルします\n3. サーバーは起動時にツールを自動的に読み込みます\n\n## クイックスタート\n\n### ツールの作成\n\n```typescript\nimport { MCPTool } from \"mcp-framework\";\nimport { z } from \"zod\";\n\ninterface ExampleInput {\n message: string;\n}\n\nclass ExampleTool extends MCPTool {\n name = \"example_tool\";\n description = \"An example tool that processes messages\";\n\n schema = {\n message: {\n type: z.string(),\n description: \"Message to process\",\n },\n };\n\n async execute(input: ExampleInput) {\n return `Processed: ${input.message}`;\n }\n}\n\nexport default ExampleTool;\n```\n\n### サーバーの設定\n\n```typescript\nimport { MCPServer } from \"mcp-framework\";\n\nconst server = new MCPServer();\n\n// OR (mutually exclusive!) with SSE transport\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n port: 8080 // Optional (default: 8080)\n }\n }\n});\n\n// Start the server\nawait server.start();\n```\n\n## トランスポート構成\n\n### stdio トランスポート (デフォルト)\n\nトランスポート構成が指定されていない場合は、デフォルトで stdio トランスポートが使用されます。\n\n```typescript\nconst server = new MCPServer();\n// or explicitly:\nconst server = new MCPServer({\n transport: { type: \"stdio\" }\n});\n```\n\n### SSEトランスポート\n\nServer-Sent Events (SSE) トランスポートを使用するには:\n\n```typescript\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n port: 8080, // Optional (default: 8080)\n endpoint: \"/sse\", // Optional (default: \"/sse\")\n messageEndpoint: \"/messages\", // Optional (default: \"/messages\")\n cors: {\n allowOrigin: \"*\", // Optional (default: \"*\")\n allowMethods: \"GET, POST, OPTIONS\", // Optional (default: \"GET, POST, OPTIONS\")\n allowHeaders: \"Content-Type, Authorization, x-api-key\", // Optional (default: \"Content-Type, Authorization, x-api-key\")\n exposeHeaders: \"Content-Type, Authorization, x-api-key\", // Optional (default: \"Content-Type, Authorization, x-api-key\")\n maxAge: \"86400\" // Optional (default: \"86400\")\n }\n }\n }\n});\n```\n\n#### CORS設定\n\nSSEトランスポートは柔軟なCORS設定をサポートしています。デフォルトでは、開発環境に適した許容設定が使用されます。本番環境では、セキュリティ要件に応じてCORSを設定する必要があります。\n\n```typescript\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n // Restrict to specific origin\n cors: {\n allowOrigin: \"https://myapp.com\",\n allowMethods: \"GET, POST\",\n allowHeaders: \"Content-Type, Authorization\",\n exposeHeaders: \"Content-Type, Authorization\",\n maxAge: \"3600\"\n }\n }\n }\n});\n\n// Or with multiple allowed origins\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n cors: {\n allowOrigin: \"https://app1.com, https://app2.com\",\n allowMethods: \"GET, POST, OPTIONS\",\n allowHeaders: \"Content-Type, Authorization, Custom-Header\",\n exposeHeaders: \"Content-Type, Authorization\",\n maxAge: \"86400\"\n }\n }\n }\n});\n```\n\n## 認証\n\nMCPフレームワークは、SSEエンドポイントにオプションの認証を提供します。JWT認証とAPIキー認証のいずれかを選択するか、独自のカスタム認証プロバイダーを実装できます。\n\n### JWT認証\n\n```typescript\nimport { MCPServer, JWTAuthProvider } from \"mcp-framework\";\nimport { Algorithm } from \"jsonwebtoken\";\n\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n auth: {\n provider: new JWTAuthProvider({\n secret: process.env.JWT_SECRET,\n algorithms: [\"HS256\" as Algorithm], // Optional (default: [\"HS256\"])\n headerName: \"Authorization\" // Optional (default: \"Authorization\")\n }),\n endpoints: {\n sse: true, // Protect SSE endpoint (default: false)\n messages: true // Protect message endpoint (default: true)\n }\n }\n }\n }\n});\n```\n\nクライアントは Authorization ヘッダーに有効な JWT トークンを含める必要があります。\n\n```\nAuthorization: Bearer eyJhbGciOiJIUzI1NiIs...\n```\n\n### APIキー認証\n\n```typescript\nimport { MCPServer, APIKeyAuthProvider } from \"mcp-framework\";\n\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n auth: {\n provider: new APIKeyAuthProvider({\n keys: [process.env.API_KEY],\n headerName: \"X-API-Key\" // Optional (default: \"X-API-Key\")\n })\n }\n }\n }\n});\n```\n\nクライアントは、X-API-Key ヘッダーに有効な API キーを含める必要があります。\n\n```\nX-API-Key: your-api-key\n```\n\n### カスタム認証\n\n`AuthProvider`インターフェイスを実装することで、独自の認証プロバイダーを実装できます。\n\n```typescript\nimport { AuthProvider, AuthResult } from \"mcp-framework\";\nimport { IncomingMessage } from \"node:http\";\n\nclass CustomAuthProvider implements AuthProvider {\n async authenticate(req: IncomingMessage): Promise {\n // Implement your custom authentication logic\n return true;\n }\n\n getAuthError() {\n return {\n status: 401,\n message: \"Authentication failed\"\n };\n }\n}\n```\n\n## ライセンス\n\nマサチューセッツ工科大学","Japanese","ja-JP",{"_27":54,"_35":58,"_37":59},{"_29":55,"_31":56,"_33":57},"도구, 리소스, 프롬프트를 자동으로 검색하고 로딩하는 기능을 갖춘 MCP(Model Context Protocol) 서버를 구축하기 위한 TypeScript 프레임워크입니다.","MCP 프레임워크","# MCP 프레임워크\n\nMCP(Model Context Protocol) 서버를 구축하기 위한 TypeScript 프레임워크입니다.\n\n## 원본과의 변경 사항\n\n이 포크(@ronangrant/mcp-framework)에는 다음과 같은 개선 사항이 포함되어 있습니다.\n\n* 더 나은 호환성과 안정성을 위해 파일 기반 로깅을 콘솔 전용 로깅으로 교체했습니다.\n* 로그에 대한 파일 시스템 종속성을 제거하여 ENOENT 오류를 제거했습니다.\n* 동일한 인터페이스를 유지하면서 로깅 구현을 간소화했습니다.\n* 이제 모든 로그가 console.error()를 통해 stderr로 출력됩니다.\n\n## 설치\n\n지엑스피1\n\n## 용법\n\n새로운 MCP 서버를 만듭니다.\n\n```typescript\nimport { MCPServer } from '@ronangrant/mcp-framework';\n\nconst server = new MCPServer({\n name: \"my-server\",\n version: \"1.0.0\"\n});\n\nawait server.start();\n```\n\n## 특징\n\n* MCP 서버 생성을 위한 사용하기 쉬운 API\n* 도구, 프롬프트 및 리소스에 대한 기본 지원\n* 콘솔 출력을 통한 간소화된 로깅 시스템\n* 전체 TypeScript 지원\n* 유연한 운송 옵션\n\n## 특허\n\nMIT\n\nMCP-Framework은 TypeScript에서 Model Context Protocol(MCP) 서버를 우아하게 구축하기 위한 프레임워크입니다.\n\nMCP-Framework는 도구, 리소스 및 프롬프트에 대한 자동 디렉터리 기반 검색 기능을 통해 즉시 사용 가능한 아키텍처를 제공합니다. 강력한 MCP 추상화를 사용하여 도구, 리소스 또는 프롬프트를 세련되게 정의하세요. CLI를 사용하면 MCP 서버를 손쉽게 시작할 수 있습니다.\n\n## 특징\n\n* 🛠️ 도구, 리소스 및 프롬프트의 자동 검색 및 로딩\n* 다중 전송 지원(stdio, SSE)\n* 완전한 유형 안전성을 갖춘 TypeScript 우선 개발\n* 공식 MCP SDK 기반으로 구축됨\n* 도구, 프롬프트 및 리소스를 위한 사용하기 쉬운 기본 클래스\n* SSE 엔드포인트에 대한 기본 인증\n\n# [전체 문서를 여기에서 읽어보세요](https://mcp-framework.com)\n\n## mcp-framework로 저장소 만들기\n\n### CLI 사용(권장)\n\n```bash\n# Install the framework globally\nnpm install -g mcp-framework\n\n# Create a new MCP server project\nmcp create my-mcp-server\n\n# Navigate to your project\ncd my-mcp-server\n\n# Your server is ready to use!\n```\n\n## CLI 사용법\n\n이 프레임워크는 MCP 서버 프로젝트를 관리하기 위한 강력한 CLI를 제공합니다.\n\n### 프로젝트 생성\n\n```bash\n# Create a new project\nmcp create \n```\n\n### 도구 추가\n\n```bash\n# Add a new tool\nmcp add tool price-fetcher\n```\n\n### 프롬프트 추가\n\n```bash\n# Add a new prompt\nmcp add prompt price-analysis\n```\n\n### 리소스 추가\n\n```bash\n# Add a new prompt\nmcp add resource market-data\n```\n\n## 개발 워크플로\n\n1. 프로젝트를 생성하세요:\n\n```bash\n mcp create my-mcp-server\n cd my-mcp-server\n```\n\n2. 필요에 따라 도구를 추가하세요:\n\n ```bash\n mcp add tool data-fetcher\n mcp add tool data-processor\n mcp add tool report-generator\n ```\n\n3. 짓다:\n\n ```bash\n npm run build\n\n ```\n\n4. MCP 클라이언트에 추가(Claude Desktop 예제는 아래를 참조하세요)\n\n## Claude Desktop과 함께 사용\n\n### 지역 개발\n\nClaude Desktop 구성 파일에 다음 구성을 추가하세요.\n\n**MacOS** : \\`~/라이브러리/애플리케이션 지원/클로드/클로드\\_데스크탑\\_config.json\\` **Windows** : \\`%APPDATA%/클로드/클로드\\_데스크탑\\_config.json\\`\n\n```json\n{\n\"mcpServers\": {\n\"${projectName}\": {\n \"command\": \"node\",\n \"args\":[\"/absolute/path/to/${projectName}/dist/index.js\"]\n}\n}\n}\n```\n\n### 출판 후\n\nClaude Desktop 구성 파일에 다음 구성을 추가하세요.\n\n**MacOS** : \\`~/라이브러리/애플리케이션 지원/클로드/클로드\\_데스크탑\\_config.json\\` **Windows** : \\`%APPDATA%/클로드/클로드\\_데스크탑\\_config.json\\`\n\n```json\n{\n\"mcpServers\": {\n\"${projectName}\": {\n \"command\": \"npx\",\n \"args\": [\"${projectName}\"]\n}\n}\n}\n```\n\n## 빌딩 및 테스트\n\n1. 도구를 변경하세요\n2. \\`npm run build\\`를 실행하여 컴파일합니다.\n3. 서버는 시작 시 자동으로 도구를 로드합니다.\n\n## 빠른 시작\n\n### 도구 만들기\n\n```typescript\nimport { MCPTool } from \"mcp-framework\";\nimport { z } from \"zod\";\n\ninterface ExampleInput {\n message: string;\n}\n\nclass ExampleTool extends MCPTool {\n name = \"example_tool\";\n description = \"An example tool that processes messages\";\n\n schema = {\n message: {\n type: z.string(),\n description: \"Message to process\",\n },\n };\n\n async execute(input: ExampleInput) {\n return `Processed: ${input.message}`;\n }\n}\n\nexport default ExampleTool;\n```\n\n### 서버 설정\n\n```typescript\nimport { MCPServer } from \"mcp-framework\";\n\nconst server = new MCPServer();\n\n// OR (mutually exclusive!) with SSE transport\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n port: 8080 // Optional (default: 8080)\n }\n }\n});\n\n// Start the server\nawait server.start();\n```\n\n## 전송 구성\n\n### stdio 전송(기본값)\n\n전송 구성이 제공되지 않으면 기본적으로 stdio 전송이 사용됩니다.\n\n```typescript\nconst server = new MCPServer();\n// or explicitly:\nconst server = new MCPServer({\n transport: { type: \"stdio\" }\n});\n```\n\n### SSE 운송\n\nSSE(Server-Sent Events) 전송을 사용하려면:\n\n```typescript\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n port: 8080, // Optional (default: 8080)\n endpoint: \"/sse\", // Optional (default: \"/sse\")\n messageEndpoint: \"/messages\", // Optional (default: \"/messages\")\n cors: {\n allowOrigin: \"*\", // Optional (default: \"*\")\n allowMethods: \"GET, POST, OPTIONS\", // Optional (default: \"GET, POST, OPTIONS\")\n allowHeaders: \"Content-Type, Authorization, x-api-key\", // Optional (default: \"Content-Type, Authorization, x-api-key\")\n exposeHeaders: \"Content-Type, Authorization, x-api-key\", // Optional (default: \"Content-Type, Authorization, x-api-key\")\n maxAge: \"86400\" // Optional (default: \"86400\")\n }\n }\n }\n});\n```\n\n#### CORS 구성\n\nSSE 전송은 유연한 CORS 구성을 지원합니다. 기본적으로 개발 환경에 적합한 허용 설정을 사용합니다. 프로덕션 환경에서는 보안 요구 사항에 따라 CORS를 구성해야 합니다.\n\n```typescript\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n // Restrict to specific origin\n cors: {\n allowOrigin: \"https://myapp.com\",\n allowMethods: \"GET, POST\",\n allowHeaders: \"Content-Type, Authorization\",\n exposeHeaders: \"Content-Type, Authorization\",\n maxAge: \"3600\"\n }\n }\n }\n});\n\n// Or with multiple allowed origins\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n cors: {\n allowOrigin: \"https://app1.com, https://app2.com\",\n allowMethods: \"GET, POST, OPTIONS\",\n allowHeaders: \"Content-Type, Authorization, Custom-Header\",\n exposeHeaders: \"Content-Type, Authorization\",\n maxAge: \"86400\"\n }\n }\n }\n});\n```\n\n## 입증\n\nMCP 프레임워크는 SSE 엔드포인트에 대한 선택적 인증을 제공합니다. JWT와 API 키 인증 중 하나를 선택하거나, 사용자 지정 인증 공급자를 직접 구현할 수 있습니다.\n\n### JWT 인증\n\n```typescript\nimport { MCPServer, JWTAuthProvider } from \"mcp-framework\";\nimport { Algorithm } from \"jsonwebtoken\";\n\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n auth: {\n provider: new JWTAuthProvider({\n secret: process.env.JWT_SECRET,\n algorithms: [\"HS256\" as Algorithm], // Optional (default: [\"HS256\"])\n headerName: \"Authorization\" // Optional (default: \"Authorization\")\n }),\n endpoints: {\n sse: true, // Protect SSE endpoint (default: false)\n messages: true // Protect message endpoint (default: true)\n }\n }\n }\n }\n});\n```\n\n클라이언트는 Authorization 헤더에 유효한 JWT 토큰을 포함해야 합니다.\n\n```\nAuthorization: Bearer eyJhbGciOiJIUzI1NiIs...\n```\n\n### API 키 인증\n\n```typescript\nimport { MCPServer, APIKeyAuthProvider } from \"mcp-framework\";\n\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n auth: {\n provider: new APIKeyAuthProvider({\n keys: [process.env.API_KEY],\n headerName: \"X-API-Key\" // Optional (default: \"X-API-Key\")\n })\n }\n }\n }\n});\n```\n\n클라이언트는 X-API-Key 헤더에 유효한 API 키를 포함해야 합니다.\n\n```\nX-API-Key: your-api-key\n```\n\n### 사용자 정의 인증\n\n`AuthProvider` 인터페이스를 구현하여 고유한 인증 공급자를 구현할 수 있습니다.\n\n```typescript\nimport { AuthProvider, AuthResult } from \"mcp-framework\";\nimport { IncomingMessage } from \"node:http\";\n\nclass CustomAuthProvider implements AuthProvider {\n async authenticate(req: IncomingMessage): Promise {\n // Implement your custom authentication logic\n return true;\n }\n\n getAuthError() {\n return {\n status: 401,\n message: \"Authentication failed\"\n };\n }\n}\n```\n\n## 특허\n\nMIT","Korean","ko-KR",{"_27":61,"_35":65,"_37":66},{"_29":62,"_31":63,"_33":64},"用于构建模型上下文协议 (MCP) 服务器的 TypeScript 框架，可自动发现和加载工具、资源和提示。","MCP框架","# MCP框架\n\n用于构建模型上下文协议 (MCP) 服务器的 TypeScript 框架。\n\n## 与原版的差异\n\n该分支（@ronangrant/mcp-framework）包括以下改进：\n\n* 用仅控制台的日志记录替换基于文件的日志记录，以获得更好的兼容性和可靠性\n* 消除了对文件系统日志的依赖，消除了 ENOENT 错误\n* 简化日志记录实现，同时保持相同的接口\n* 所有日志现在通过 console.error() 输出到 stderr\n\n## 安装\n\n```bash\nnpm install @ronangrant/mcp-framework\n```\n\n## 用法\n\n创建一个新的 MCP 服务器：\n\n```typescript\nimport { MCPServer } from '@ronangrant/mcp-framework';\n\nconst server = new MCPServer({\n name: \"my-server\",\n version: \"1.0.0\"\n});\n\nawait server.start();\n```\n\n## 特征\n\n* 用于创建 MCP 服务器的易于使用的 API\n* 内置对工具、提示和资源的支持\n* 带有控制台输出的简化日志系统\n* 全面支持 TypeScript\n* 灵活的交通选择\n\n## 执照\n\n麻省理工学院\n\nMCP-Framework 是一个使用 TypeScript 优雅地构建模型上下文协议 (MCP) 服务器的框架。\n\nMCP-Framework 为您提供开箱即用的架构，并支持基于目录的自动工具、资源和提示符发现功能。使用我们强大的 MCP 抽象，您可以优雅地定义工具、资源或提示符。我们的命令行界面让您轻松上手 MCP 服务器。\n\n## 特征\n\n* 🛠️ 自动发现和加载工具、资源和提示\n* 多种传输支持（stdio、SSE）\n* 具有完全类型安全性的 TypeScript 优先开发\n* 基于官方 MCP SDK 构建\n* 易于使用的工具、提示和资源基类\n* SSE 端点的开箱即用身份验证\n\n# [点击此处阅读完整文档](https://mcp-framework.com)\n\n## 使用 mcp-framework 创建存储库\n\n### 使用 CLI（推荐）\n\n```bash\n# Install the framework globally\nnpm install -g mcp-framework\n\n# Create a new MCP server project\nmcp create my-mcp-server\n\n# Navigate to your project\ncd my-mcp-server\n\n# Your server is ready to use!\n```\n\n## CLI 使用\n\n该框架提供了强大的 CLI 来管理您的 MCP 服务器项目：\n\n### 项目创建\n\n```bash\n# Create a new project\nmcp create \n```\n\n### 添加工具\n\n```bash\n# Add a new tool\nmcp add tool price-fetcher\n```\n\n### 添加提示\n\n```bash\n# Add a new prompt\nmcp add prompt price-analysis\n```\n\n### 添加资源\n\n```bash\n# Add a new prompt\nmcp add resource market-data\n```\n\n## 开发工作流程\n\n1. 创建你的项目：\n\n```bash\n mcp create my-mcp-server\n cd my-mcp-server\n```\n\n2. 根据需要添加工具：\n\n ```bash\n mcp add tool data-fetcher\n mcp add tool data-processor\n mcp add tool report-generator\n ```\n\n3. 建造：\n\n ```bash\n npm run build\n\n ```\n\n4. 添加到 MCP 客户端（请参阅下面的 Claude Desktop 示例）\n\n## 与 Claude Desktop 一起使用\n\n### 本地开发\n\n将此配置添加到您的 Claude Desktop 配置文件：\n\n**MacOS** ：\\`~/Library/Application Support/Claude/claude\\_desktop\\_config.json\\` **Windows** ：\\`%APPDATA%/Claude/claude\\_desktop\\_config.json\\`\n\n```json\n{\n\"mcpServers\": {\n\"${projectName}\": {\n \"command\": \"node\",\n \"args\":[\"/absolute/path/to/${projectName}/dist/index.js\"]\n}\n}\n}\n```\n\n### 发布后\n\n将此配置添加到您的 Claude Desktop 配置文件：\n\n**MacOS** ：\\`~/Library/Application Support/Claude/claude\\_desktop\\_config.json\\` **Windows** ：\\`%APPDATA%/Claude/claude\\_desktop\\_config.json\\`\n\n```json\n{\n\"mcpServers\": {\n\"${projectName}\": {\n \"command\": \"npx\",\n \"args\": [\"${projectName}\"]\n}\n}\n}\n```\n\n## 构建和测试\n\n1. 更改你的工具\n2. 运行 \\`npm run build\\` 进行编译\n3. 服务器将在启动时自动加载您的工具\n\n## 快速入门\n\n### 创建工具\n\n```typescript\nimport { MCPTool } from \"mcp-framework\";\nimport { z } from \"zod\";\n\ninterface ExampleInput {\n message: string;\n}\n\nclass ExampleTool extends MCPTool {\n name = \"example_tool\";\n description = \"An example tool that processes messages\";\n\n schema = {\n message: {\n type: z.string(),\n description: \"Message to process\",\n },\n };\n\n async execute(input: ExampleInput) {\n return `Processed: ${input.message}`;\n }\n}\n\nexport default ExampleTool;\n```\n\n### 设置服务器\n\n```typescript\nimport { MCPServer } from \"mcp-framework\";\n\nconst server = new MCPServer();\n\n// OR (mutually exclusive!) with SSE transport\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n port: 8080 // Optional (default: 8080)\n }\n }\n});\n\n// Start the server\nawait server.start();\n```\n\n## 传输配置\n\n### stdio 传输（默认）\n\n如果没有提供传输配置，则默认使用 stdio 传输：\n\n```typescript\nconst server = new MCPServer();\n// or explicitly:\nconst server = new MCPServer({\n transport: { type: \"stdio\" }\n});\n```\n\n### 上交所运输\n\n要使用服务器发送事件 (SSE) 传输：\n\n```typescript\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n port: 8080, // Optional (default: 8080)\n endpoint: \"/sse\", // Optional (default: \"/sse\")\n messageEndpoint: \"/messages\", // Optional (default: \"/messages\")\n cors: {\n allowOrigin: \"*\", // Optional (default: \"*\")\n allowMethods: \"GET, POST, OPTIONS\", // Optional (default: \"GET, POST, OPTIONS\")\n allowHeaders: \"Content-Type, Authorization, x-api-key\", // Optional (default: \"Content-Type, Authorization, x-api-key\")\n exposeHeaders: \"Content-Type, Authorization, x-api-key\", // Optional (default: \"Content-Type, Authorization, x-api-key\")\n maxAge: \"86400\" // Optional (default: \"86400\")\n }\n }\n }\n});\n```\n\n#### CORS 配置\n\nSSE 传输支持灵活的 CORS 配置。默认情况下，它使用适合开发的宽松设置。对于生产环境，您应该根据自己的安全需求配置 CORS：\n\n```typescript\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n // Restrict to specific origin\n cors: {\n allowOrigin: \"https://myapp.com\",\n allowMethods: \"GET, POST\",\n allowHeaders: \"Content-Type, Authorization\",\n exposeHeaders: \"Content-Type, Authorization\",\n maxAge: \"3600\"\n }\n }\n }\n});\n\n// Or with multiple allowed origins\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n cors: {\n allowOrigin: \"https://app1.com, https://app2.com\",\n allowMethods: \"GET, POST, OPTIONS\",\n allowHeaders: \"Content-Type, Authorization, Custom-Header\",\n exposeHeaders: \"Content-Type, Authorization\",\n maxAge: \"86400\"\n }\n }\n }\n});\n```\n\n## 验证\n\nMCP 框架为 SSE 端点提供了可选的身份验证方式。您可以选择 JWT 或 API Key 身份验证，也可以实现自定义的身份验证提供程序。\n\n### JWT 身份验证\n\n```typescript\nimport { MCPServer, JWTAuthProvider } from \"mcp-framework\";\nimport { Algorithm } from \"jsonwebtoken\";\n\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n auth: {\n provider: new JWTAuthProvider({\n secret: process.env.JWT_SECRET,\n algorithms: [\"HS256\" as Algorithm], // Optional (default: [\"HS256\"])\n headerName: \"Authorization\" // Optional (default: \"Authorization\")\n }),\n endpoints: {\n sse: true, // Protect SSE endpoint (default: false)\n messages: true // Protect message endpoint (default: true)\n }\n }\n }\n }\n});\n```\n\n客户端必须在授权标头中包含有效的 JWT 令牌：\n\n```\nAuthorization: Bearer eyJhbGciOiJIUzI1NiIs...\n```\n\n### API 密钥认证\n\n```typescript\nimport { MCPServer, APIKeyAuthProvider } from \"mcp-framework\";\n\nconst server = new MCPServer({\n transport: {\n type: \"sse\",\n options: {\n auth: {\n provider: new APIKeyAuthProvider({\n keys: [process.env.API_KEY],\n headerName: \"X-API-Key\" // Optional (default: \"X-API-Key\")\n })\n }\n }\n }\n});\n```\n\n客户端必须在 X-API-Key 标头中包含有效的 API 密钥：\n\n```\nX-API-Key: your-api-key\n```\n\n### 自定义身份验证\n\n您可以通过实现`AuthProvider`接口来实现自己的身份验证提供程序：\n\n```typescript\nimport { AuthProvider, AuthResult } from \"mcp-framework\";\nimport { IncomingMessage } from \"node:http\";\n\nclass CustomAuthProvider implements AuthProvider {\n async authenticate(req: IncomingMessage): Promise {\n // Implement your custom authentication logic\n return true;\n }\n\n getAuthError() {\n return {\n status: 401,\n message: \"Authentication failed\"\n };\n }\n}\n```\n\n## 执照\n\n麻省理工学院","Chinese","zh-CN","githubUser","locale",{"_70":71,"_13":72,"_78":30,"_79":30,"_31":32,"_16":80,"_81":82,"_107":108,"_115":-5,"_116":-5,"_117":118,"_159":160,"_164":-5,"_89":141,"_165":145,"_91":166,"_167":168},"addedAt","2025-03-25T07:01:40.541398Z",[73,74,75,76,77],"category:developer-tools","category:code-execution","category:agent-orchestration","hosting:hybrid","language:typescript","descriptionMarkdown","descriptionPlainText",3612,"integrations",[83,93,100],{"_84":85,"_29":90,"_91":92},"brand",{"_86":87,"_35":88,"_89":88},"logoSvgPath","M1.763 0C.786 0 0 .786 0 1.763v20.474C0 23.214.786 24 1.763 24h20.474c.977 0 1.763-.786 1.763-1.763V1.763C24 .786 23.214 0 22.237 0zM5.13 5.323l13.837.019-.009 13.836h-3.464l.01-10.382h-3.456L12.04 19.17H5.113z","npm","slug","Supports distribution through npm, allowing developers to publish their MCP servers and have users install them with a simple npx command.","uid","nt3yhzom74",{"_84":94,"_29":98,"_91":99},{"_86":95,"_35":96,"_89":97},"M1.125 0C.502 0 0 .502 0 1.125v21.75C0 23.498.502 24 1.125 24h21.75c.623 0 1.125-.502 1.125-1.125V1.125C24 .502 23.498 0 22.875 0zm17.363 9.75c.612 0 1.154.037 1.627.111a6.38 6.38 0 0 1 1.306.34v2.458a3.95 3.95 0 0 0-.643-.361 5.093 5.093 0 0 0-.717-.26 5.453 5.453 0 0 0-1.426-.2c-.3 0-.573.028-.819.086a2.1 2.1 0 0 0-.623.242c-.17.104-.3.229-.393.374a.888.888 0 0 0-.14.49c0 .196.053.373.156.529.104.156.252.304.443.444s.423.276.696.41c.273.135.582.274.926.416.47.197.892.407 1.266.628.374.222.695.473.963.753.268.279.472.598.614.957.142.359.214.776.214 1.253 0 .657-.125 1.21-.373 1.656a3.033 3.033 0 0 1-1.012 1.085 4.38 4.38 0 0 1-1.487.596c-.566.12-1.163.18-1.79.18a9.916 9.916 0 0 1-1.84-.164 5.544 5.544 0 0 1-1.512-.493v-2.63a5.033 5.033 0 0 0 3.237 1.2c.333 0 .624-.03.872-.09.249-.06.456-.144.623-.25.166-.108.29-.234.373-.38a1.023 1.023 0 0 0-.074-1.089 2.12 2.12 0 0 0-.537-.5 5.597 5.597 0 0 0-.807-.444 27.72 27.72 0 0 0-1.007-.436c-.918-.383-1.602-.852-2.053-1.405-.45-.553-.676-1.222-.676-2.005 0-.614.123-1.141.369-1.582.246-.441.58-.804 1.004-1.089a4.494 4.494 0 0 1 1.47-.629 7.536 7.536 0 0 1 1.77-.201zm-15.113.188h9.563v2.166H9.506v9.646H6.789v-9.646H3.375z","TypeScript","typescript","Built specifically for TypeScript with full type safety, enabling developers to create MCP tools, prompts, and resources with proper typing and validation.","wpaugh3zpf",{"_84":101,"_29":105,"_91":106},{"_86":102,"_35":103,"_89":104},"M19.088 2.477 24 7.606 12.521 20.485l-.925 1.038L0 7.559l5.108-5.082h13.98Zm-17.434 5.2 6.934-4.003H5.601L1.619 7.636l.035.041Zm12.117-4.003L3.333 9.7l2.149 2.588 10.809-6.241-.2-.346 2.851-1.646-.365-.381h-4.806Zm7.52 2.834L8.257 14.034h5.101v-.4h3.667l5.346-5.998-1.08-1.128Zm-7.129 10.338H9.268l2.36 2.843 2.534-2.843Z","Zod","zod","Uses Zod for schema validation in tools, allowing developers to define input validation schemas for tool parameters with proper typing and runtime validation.","qh2r9548ee","namespace",{"_109":110,"_89":114},"owner",{"_111":112},"githubAccount",{"_113":114},"login","ronangrant","readmeMarkdown","redditPostExternalId","repository",{"_119":120,"_127":128,"_131":132,"_148":-5,"_149":150,"_151":152,"_155":156},"argumentsJsonSchema",{"_121":122,"_123":124,"_125":126},"properties",{},"required",[],"type","object","githubProject",{"_33":34,"_129":130},"url","https://github.com/ronangrant/mcp-framework","githubRepository",{"_133":134,"_135":136,"_137":138,"_16":139,"_140":96,"_35":141,"_109":142,"_144":145,"_146":-5,"_147":145},"defaultBranch","main","fullName","ronangrant/mcp-framework","githubTreeId",313518,6039,"language","mcp-framework",{"_113":114,"_91":143},"MJvapAbO9y","recentStargazers",0,"spdxLicense","stargazers","glamaJson","inspectable",false,"npmPackage",{"_35":153,"_154":145},"@ronangrant/mcp-framework","weeklyDownloads","supportedPlatforms",[157,158],"MACOS","WINDOWS","scores",{"_161":-5,"_162":-5,"_163":-5},"license","quality","security","simpleIcon","toolCount","u9oawtxwj5","updatedAt","2025-10-01T12:06:20.478758Z","meta",[171,174,176,183,186,188,191,194,197,200,203,205,208,211,213,215,217,219,221],{"_172":173},"title","MCP Framework | Glama",{"_175":30,"_35":29},"content",{"_177":178,"_179":180,"_181":182},"href","https://glama.ai/mcp/servers/@ronangrant/mcp-framework","rel","canonical","tagName","link",{"_175":32,"_184":185},"property","og:title",{"_175":30,"_184":187},"og:description",{"_175":189,"_184":190},"https://glama.ai/logo.png","og:logo",{"_175":192,"_184":193},"https://glama.ai/mcp/servers/@ronangrant/mcp-framework/og-image","og:image",{"_175":195,"_184":196},"630","og:image:height",{"_175":198,"_184":199},"1200","og:image:width",{"_175":201,"_184":202},"website","og:type",{"_175":178,"_184":204},"og:url",{"_175":206,"_184":207},"Glama – MCP Hosting Platform","og:site_name",{"_175":209,"_35":210},"summary_large_image","twitter:card",{"_175":206,"_35":212},"twitter:title",{"_175":30,"_35":214},"twitter:description",{"_175":192,"_35":216},"twitter:image",{"_175":195,"_35":218},"twitter:image:height",{"_175":198,"_35":220},"twitter:image:width",{"_222":223},"script:ld+json",{"_224":225,"_226":227},"@context","http://schema.org","@graph",[228],{"_224":229,"_230":231,"_232":233},"https://schema.org","@type","BreadcrumbList","itemListElement",[234,241,245,249],{"_230":235,"_236":237,"_35":238,"_239":240},"ListItem","item","/","Glama","position",1,{"_230":235,"_236":242,"_35":243,"_239":244},"/mcp","MCP",2,{"_230":235,"_236":246,"_35":247,"_239":248},"/mcp/servers","Servers",3,{"_230":235,"_236":250,"_35":32,"_239":251},"/mcp/servers/@ronangrant/mcp-framework",4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~commit/~/_route",{"_255":256,"_27":262,"_284":285,"_169":299,"_296":323,"_324":325},"blob",{"_175":257,"_258":259,"_260":261},"export function toPascalCase(str: string): string {\n return str\n .split(/[-_]/)\n .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\n .join(\"\");\n}\n","fileName","string-utils.ts","size",180,{"_70":71,"_13":263,"_78":30,"_79":30,"_31":32,"_16":80,"_81":264,"_107":271,"_115":-5,"_116":-5,"_117":274,"_159":283,"_164":-5,"_89":141,"_165":145,"_91":166,"_167":168},[73,74,75,76,77],[265,267,269],{"_84":266,"_29":90,"_91":92},{"_86":87,"_35":88,"_89":88},{"_84":268,"_29":98,"_91":99},{"_86":95,"_35":96,"_89":97},{"_84":270,"_29":105,"_91":106},{"_86":102,"_35":103,"_89":104},{"_109":272,"_89":114},{"_111":273},{"_113":114},{"_119":275,"_127":278,"_131":279,"_148":-5,"_149":150,"_151":281,"_155":282},{"_121":276,"_123":277,"_125":126},{},[],{"_33":34,"_129":130},{"_133":134,"_135":136,"_137":138,"_16":139,"_140":96,"_35":141,"_109":280,"_144":145,"_146":-5,"_147":145},{"_113":114,"_91":143},{"_35":153,"_154":145},[157,158],{"_161":-5,"_162":-5,"_163":-5},"member",{"_286":287,"_290":291,"_292":293,"_137":294,"_295":150,"_296":259,"_297":298,"_260":261,"_125":255},"commit",{"_288":289},"sha","56d8334481042c2cfedb53883df2a0e52194714b","contentStoredObjectPointerId",10199606,"fullPath","src/cli/utils/string-utils.ts",313505,"indexable","path","safeToDisplayAsText",true,[300,302,304,306,308,309,310,312,313,314,315,316,317,318,319,320,321,322],{"_172":301},"string-utils.ts | MCP Framework | Glama",{"_175":303,"_35":29},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_177":305,"_179":180,"_181":182},"https://glama.ai/mcp/servers/@ronangrant/mcp-framework/blob/56d8334481042c2cfedb53883df2a0e52194714b/src/cli/utils",{"_175":307,"_184":185},"string-utils.ts | MCP Framework",{"_175":303,"_184":187},{"_175":189,"_184":190},{"_175":311,"_184":193},"https://glama.ai/generated-images/og?title=string-utils.ts+%7C+MCP+Framework",{"_175":195,"_184":196},{"_175":198,"_184":199},{"_175":201,"_184":202},{"_175":305,"_184":204},{"_175":206,"_184":207},{"_175":209,"_35":210},{"_175":206,"_35":212},{"_175":303,"_35":214},{"_175":311,"_35":216},{"_175":195,"_35":218},{"_175":198,"_35":220},"src/cli/utils","treeMembers",[326,328],{"_286":327,"_292":293,"_296":259,"_125":255},{"_288":289},{"_286":329,"_292":330,"_296":331,"_125":255},{"_288":289},"src/cli/utils/validate-project.ts","validate-project.ts","actionData","errors"]

MCP directory API