@lee2026/hello-world-mcp 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const http_client_js_1 = require("./utils/http-client.js");
+const hello_js_1 = require("./tools/hello.js");
+const server = new index_js_1.Server({ name: 'hello-world-mcp', version: '1.0.0' }, { capabilities: { tools: {} } });
+const tools = new hello_js_1.HelloTools((0, http_client_js_1.createHttpClient)());
+// 注册工具列表
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: 'hello_world',
+            description: 'Hello World 接口，根据用户ID返回问候信息',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    userId: { type: 'string', description: '用户ID' },
+                },
+                required: ['userId'],
+            },
+        },
+    ],
+}));
+// 注册工具调用
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (req) => {
+    const { name, arguments: args } = req.params;
+    let result;
+    switch (name) {
+        case 'hello_world':
+            result = await tools.helloWorld(args || {});
+            break;
+        default:
+            throw new types_js_1.McpError(types_js_1.ErrorCode.MethodNotFound, `未知工具: ${name}`);
+    }
+    return { content: [{ type: 'text', text: result }] };
+});
+// 启动服务
+async function main() {
+    await server.connect(new stdio_js_1.StdioServerTransport());
+    console.error('Hello World MCP Server 已启动');
+}
+main().catch((e) => {
+    console.error('启动失败:', e);
+    process.exit(1);
+});

package/dist/tools/hello.d.ts

@@ -0,0 +1,6 @@
+import { AxiosInstance } from 'axios';
+export declare class HelloTools {
+    private http;
+    constructor(http: AxiosInstance);
+    helloWorld(args: Record<string, unknown>): Promise<string>;
+}

package/dist/tools/hello.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HelloTools = void 0;
+const validator_js_1 = require("../utils/validator.js");
+class HelloTools {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    async helloWorld(args) {
+        try {
+            const userId = (0, validator_js_1.validateString)(args.userId, '用户ID');
+            const res = await this.http.get('/api/hello', { params: { userId } });
+            return JSON.stringify({ success: true, data: res.data });
+        }
+        catch (e) {
+            return JSON.stringify({ success: false, error: e instanceof Error ? e.message : '未知错误' });
+        }
+    }
+}
+exports.HelloTools = HelloTools;

package/dist/types/index.d.ts

@@ -0,0 +1,12 @@
+export interface HelloWorldRequest {
+    userId: string;
+}
+export interface ApiResponse<T = unknown> {
+    code: number;
+    message: string;
+    data: T;
+}
+export interface HelloWorldData {
+    greeting: string;
+    userId: string;
+}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils/http-client.d.ts

@@ -0,0 +1,2 @@
+import { AxiosInstance } from 'axios';
+export declare function createHttpClient(): AxiosInstance;

package/dist/utils/http-client.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createHttpClient = createHttpClient;
+const axios_1 = __importDefault(require("axios"));
+function createHttpClient() {
+    const baseURL = process.env.API_BASE;
+    const apiKey = process.env.API_KEY;
+    if (!baseURL)
+        throw new Error('环境变量 API_BASE 未配置');
+    if (!apiKey)
+        throw new Error('环境变量 API_KEY 未配置');
+    return axios_1.default.create({
+        baseURL,
+        timeout: 30000,
+        headers: {
+            'Content-Type': 'application/json',
+            'X-API-Key': apiKey,
+        },
+    });
+}

package/dist/utils/validator.d.ts

@@ -0,0 +1,5 @@
+export declare class ValidationError extends Error {
+    constructor(message: string);
+}
+export declare function validateString(value: unknown, field: string): string;
+export declare function validateNumber(value: unknown, field: string, min?: number, max?: number): number;

package/dist/utils/validator.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationError = void 0;
+exports.validateString = validateString;
+exports.validateNumber = validateNumber;
+class ValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ValidationError';
+    }
+}
+exports.ValidationError = ValidationError;
+function validateString(value, field) {
+    if (!value || typeof value !== 'string') {
+        throw new ValidationError(`${field} 不能为空`);
+    }
+    return value.trim();
+}
+function validateNumber(value, field, min, max) {
+    const num = typeof value === 'string' ? parseFloat(value) : value;
+    if (typeof num !== 'number' || isNaN(num)) {
+        throw new ValidationError(`${field} 必须是数字`);
+    }
+    if (min !== undefined && num < min)
+        throw new ValidationError(`${field} 不能小于 ${min}`);
+    if (max !== undefined && num > max)
+        throw new ValidationError(`${field} 不能大于 ${max}`);
+    return num;
+}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@lee2026/hello-world-mcp",
+  "version": "1.0.0",
+  "main": "dist/index.js",
+  "bin": { "hello-world-mcp": "./dist/index.js" },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "engines": { "node": ">=18.0.0" },
+  "files": ["dist/**/*", "README.md"],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "axios": "^1.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0"
+  }
+}