@pero-mcp/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pero Games
+
+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.

package/dist/base-server.d.ts

@@ -0,0 +1,41 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * 工具处理函数类型
+ */
+export type ToolHandler = (args: Record<string, unknown>) => Promise<unknown>;
+/**
+ * 基础 MCP Server 类
+ * 提供工具注册、stdio 传输等通用功能
+ */
+export declare abstract class BaseMCPServer {
+    protected name: string;
+    protected version: string;
+    protected server: Server;
+    protected tools: Map<string, {
+        definition: Tool;
+        handler: ToolHandler;
+    }>;
+    constructor(name: string, version: string);
+    /**
+     * 注册工具
+     */
+    protected registerTool(definition: Tool, handler: ToolHandler): void;
+    /**
+     * 设置请求处理器
+     */
+    private setupHandlers;
+    /**
+     * 初始化服务器（子类实现，注册具体工具）
+     */
+    protected abstract initialize(): Promise<void>;
+    /**
+     * 启动 stdio 模式服务器
+     */
+    runStdio(): Promise<void>;
+    /**
+     * 获取 Server 实例（用于 HTTP 模式）
+     */
+    getServer(): Server;
+}
+//# sourceMappingURL=base-server.d.ts.map

package/dist/base-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-server.d.ts","sourceRoot":"","sources":["../src/base-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,EAGL,IAAI,EACL,MAAM,oCAAoC,CAAC;AAG5C;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE9E;;;GAGG;AACH,8BAAsB,aAAa;IAK/B,SAAS,CAAC,IAAI,EAAE,MAAM;IACtB,SAAS,CAAC,OAAO,EAAE,MAAM;IAL3B,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,IAAI,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,CAAC,CAAa;gBAGzE,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM;IAiB3B;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAIpE;;OAEG;IACH,OAAO,CAAC,aAAa;IAiCrB;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAE9C;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAS/B;;OAEG;IACH,SAAS,IAAI,MAAM;CAGpB"}

package/dist/base-server.js

@@ -0,0 +1,81 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { MCPError } from '@pero-mcp/shared';
+/**
+ * 基础 MCP Server 类
+ * 提供工具注册、stdio 传输等通用功能
+ */
+export class BaseMCPServer {
+    name;
+    version;
+    server;
+    tools = new Map();
+    constructor(name, version) {
+        this.name = name;
+        this.version = version;
+        this.server = new Server({
+            name: this.name,
+            version: this.version,
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        this.setupHandlers();
+    }
+    /**
+     * 注册工具
+     */
+    registerTool(definition, handler) {
+        this.tools.set(definition.name, { definition, handler });
+    }
+    /**
+     * 设置请求处理器
+     */
+    setupHandlers() {
+        // 列出所有工具
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
+            tools: Array.from(this.tools.values()).map((t) => t.definition),
+        }));
+        // 调用工具
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const toolName = request.params.name;
+            const tool = this.tools.get(toolName);
+            if (!tool) {
+                throw new MCPError(`Unknown tool: ${toolName}`, 'UNKNOWN_TOOL', 404);
+            }
+            try {
+                const result = await tool.handler(request.params.arguments || {});
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                throw new MCPError(`Tool execution failed: ${message}`, 'TOOL_EXECUTION_ERROR', 500);
+            }
+        });
+    }
+    /**
+     * 启动 stdio 模式服务器
+     */
+    async runStdio() {
+        await this.initialize();
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        console.error(`${this.name} v${this.version} running on stdio`);
+    }
+    /**
+     * 获取 Server 实例（用于 HTTP 模式）
+     */
+    getServer() {
+        return this.server;
+    }
+}
+//# sourceMappingURL=base-server.js.map

package/dist/base-server.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { BaseMCPServer, type ToolHandler } from './base-server.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { BaseMCPServer } from './base-server.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAoB,MAAM,kBAAkB,CAAC"}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@pero-mcp/core",
+  "version": "0.1.0",
+  "description": "Base MCP server implementation with stdio/http transport",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "@pero-mcp/shared": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.2"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "lint": "tsc --noEmit"
+  }
+}