stdio-node-demo 1.0.2

package/LICENSE

@@ -0,0 +1,197 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+   "License" shall mean the terms and conditions for use, reproduction,
+   and distribution as defined by Sections 1 through 9 of this document.
+
+   "Licensor" shall mean the copyright owner or entity authorized by
+   the copyright owner that is granting the License.
+
+   "Legal Entity" shall mean the union of the acting entity and all
+   other entities that control, are controlled by, or are under common
+   control with that entity. For the purposes of this definition,
+   "control" means (i) the power, direct or indirect, to cause the
+   direction or management of such entity, whether by contract or
+   otherwise, or (ii) ownership of fifty percent (50%) or more of the
+   outstanding shares, or (iii) beneficial ownership of such entity.
+
+   "You" (or "Your") shall mean an individual or Legal Entity
+   exercising permissions granted by this License.
+
+   "Source" form shall mean the preferred form for making modifications,
+   including but not limited to software source code, documentation
+   source, and configuration files.
+
+   "Object" form shall mean any form resulting from mechanical
+   transformation or translation of a Source form, including but not
+   limited to compiled object code, generated documentation, and
+   conversions to other media types.
+
+   "Work" shall mean the work of authorship, whether in Source or
+   Object form, made available under the License, as indicated by a
+   copyright notice that is included in or attached to the work
+   (an example is provided in the Appendix below).
+
+   "Derivative Works" shall mean any work, whether in Source or Object
+   form, that is based on (or derived from) the Work and for which the
+   editorial revisions, annotations, elaborations, or other modifications
+   represent, as a whole, an original work of authorship. For the purposes
+   of this License, Derivative Works shall not include works that remain
+   separable from, or merely link (or bind by name) to the interfaces of,
+   the Work and Derivative Works thereof.
+
+   "Contribution" shall mean any work of authorship, including the
+   original version of the Work and any modifications or additions
+   to that Work or Derivative Works thereof, that is intentionally
+   submitted to Licensor for inclusion in the Work by the copyright owner
+   or by an individual or Legal Entity authorized to submit on behalf of
+   the copyright owner. For the purposes of this definition, "submitted"
+   means any form of electronic, verbal, or written communication sent
+   to the Licensor or its representatives, including but not limited to
+   communication on electronic mailing lists, source code control systems,
+   and issue tracking systems that are managed by, or on behalf of, the
+   Licensor for the purpose of discussing and improving the Work, but
+   excluding communication that is conspicuously marked or otherwise
+   designated in writing by the copyright owner as "Not a Contribution."
+
+   "Contributor" shall mean Licensor and any individual or Legal Entity
+   on behalf of whom a Contribution has been received by Licensor and
+   subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   copyright license to reproduce, prepare Derivative Works of, publicly
+   display, publicly perform, sublicense, and distribute the Work and
+   such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   (except as stated in this section) patent license to make, have made,
+   use, offer to sell, sell, import, and otherwise transfer the Work,
+   where such license applies only to those patent claims licensable
+   by such Contributor that are necessarily infringed by their
+   Contribution(s) alone or by combination of their Contribution(s)
+   with the Work to which such Contribution(s) was submitted. If You
+   institute patent litigation against any entity (including a
+   cross-claim or counterclaim in a lawsuit) alleging that the Work
+   or a Contribution incorporated within the Work constitutes direct
+   or contributory patent infringement, then any patent licenses
+   granted to You under this License for that Work shall terminate
+   as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+   Work or Derivative Works thereof in any medium, with or without
+   modifications, and in Source or Object form, provided that You
+   meet the following conditions:
+
+   (a) You must give any other recipients of the Work or Derivative
+       Works a copy of this License; and
+
+   (b) You must cause any modified files to carry prominent notices
+       stating that You changed the files; and
+
+   (c) You must retain, in the Source form of any Derivative Works that
+       You distribute, all copyright, patent, trademark, and attribution
+       notices from the Source form of the Work, excluding those notices
+       that do not pertain to any part of the Derivative Works; and
+
+   (d) If the Work includes a "NOTICE" text file as part of its
+       distribution, then any Derivative Works that You distribute must
+       include a readable copy of the attribution notices contained
+       within such NOTICE file, excluding those notices that do not
+       pertain to any part of the Derivative Works, in at least one of
+       the following places: within a NOTICE text file distributed
+       as part of the Derivative Works; within the Source form or
+       documentation, if provided along with the Derivative Works; or,
+       within a display generated by the Derivative Works, if and
+       wherever such third-party notices normally appear. The contents
+       of the NOTICE file are for informational purposes only and do
+       not modify the License. You may add Your own attribution
+       notices within Derivative Works that You distribute, alongside
+       or as an addendum to the NOTICE text from the Work, provided
+       that such additional attribution notices cannot be construed
+       as modifying the License.
+
+   You may add Your own copyright statement to Your modifications and
+   may provide additional or different license terms and conditions
+   for use, reproduction, or distribution of Your modifications, or
+   for any such Derivative Works as a whole, provided Your use,
+   reproduction, and distribution of the Work otherwise complies with
+   the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+   any Contribution intentionally submitted for inclusion in the Work
+   by You to the Licensor shall be under the terms and conditions of
+   this License, without any additional terms or conditions.
+   Notwithstanding the above, nothing herein shall supersede or modify
+   the terms of any separate license agreement you may have executed
+   with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+   names, trademarks, service marks, or product names of the Licensor,
+   except as required for reasonable and customary use in describing the
+   origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+   agreed to in writing, Licensor provides the Work (and each
+   Contributor provides its Contributions) on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+   implied, including, without limitation, any warranties or conditions
+   of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+   PARTICULAR PURPOSE. You are solely responsible for determining the
+   appropriateness of using or redistributing the Work and assume any
+   risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+   whether in tort (including negligence), contract, or otherwise,
+   unless required by applicable law (such as deliberate and grossly
+   negligent acts) or agreed to in writing, shall any Contributor be
+   liable to You for damages, including any direct, indirect, special,
+   incidental, or consequential damages of any character arising as a
+   result of this License or out of the use or inability to use the
+   Work (including but not limited to damages for loss of goodwill,
+   work stoppage, computer failure or malfunction, or any and all
+   other commercial damages or losses), even if such Contributor
+   has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+   the Work or Derivative Works thereof, You may choose to offer,
+   and charge a fee for, acceptance of support, warranty, indemnity,
+   or other liability obligations and/or rights consistent with this
+   License. However, in accepting such obligations, You may act only
+   on Your own behalf and on Your sole responsibility, not on behalf
+   of any other Contributor, and only if You agree to indemnify,
+   defend, and hold each Contributor harmless for any liability
+   incurred by, or claims asserted against, such Contributor by reason
+   of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+   To apply the Apache License to your work, attach the following
+   boilerplate notice, with the fields enclosed by brackets "[]" replaced
+   with your own identifying information. (Don't include the brackets.)
+   The text should be placed in a file called "LICENSE" at the root of
+   your project, and optionally included in the headers of source files.
+
+   Copyright 2026 Dave Johnson
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,272 @@
+# MCP TypeScript Stdio 示例项目
+
+这是一个可分发的 Model Context Protocol (MCP) 服务端示例，采用了 `stdio` 协议进行通讯。
+
+## 目录结构
+
+项目采用了标准推荐的 `src` 布局：
+- `src/`: 源代码目录
+  - `index.ts`: 主入口文件
+  - `resources/`: MCP 资源定义
+  - `tools/`: MCP 工具定义
+- `dist/`: 编译后的 JavaScript 输出
+- `package.json`: 包含打包元数据和入口点配置
+
+## 如何作为用户直接运行
+
+如果你将此项目发布到 npm，其他用户**无需手动下载代码**，可以直接通过 `npx` 运行：
+
+```bash
+# 如果已发布到 npm
+npx stdio-node-demo
+```
+
+或者从 GitHub 仓库直接运行（如果配置了 GitHub Actions 或其他分发方式）：
+
+```bash
+# 替换为你的 GitHub 仓库地址
+npx github:YOUR_USERNAME/mcp-hello-world-ts
+```
+
+## 本地开发与运行
+
+### 1. 安装环境
+
+```bash
+npm install
+```
+
+### 2. 构建项目
+
+编译 TypeScript 源代码到 JavaScript：
+
+```bash
+npm run build
+```
+
+### 3. 运行服务端
+
+项目配置了 `stdio-node-demo` 入口点，可以直接运行：
+
+```bash
+npm start
+```
+
+或者直接使用 node：
+
+```bash
+node dist/index.js
+```
+
+### 4. 测试验证
+
+使用 MCP Inspector 进行测试：
+
+```bash
+npx @modelcontextprotocol/inspector node dist/index.js
+```
+
+或者运行集成测试：
+
+```bash
+npm test
+```
+
+## 分发到公共仓库 (npm) 的建议
+
+如果你想让用户直接通过 `npx stdio-node-demo` 运行：
+
+1. 注册 [npm](https://www.npmjs.com/) 账号。
+2. 在项目根目录运行 `npm run build` 构建项目。
+3. 使用 `npm publish` 将构建好的包发布。
+
+发布后，用户的运行体验将非常顺滑：
+
+```bash
+npx stdio-node-demo
+```
+
+在 Claude Desktop 中的配置示例：
+
+```json
+{
+  "mcpServers": {
+    "stdio-node-demo": {
+      "command": "npx",
+      "args": [
+        "stdio-node-demo"
+      ],
+      "env": {
+        "GREETING_PREFIX": "你好"
+      }
+    }
+  }
+}
+```
+
+或者使用本地开发版本：
+
+```json
+{
+  "mcpServers": {
+    "stdio-node-demo": {
+      "command": "node",
+      "args": [
+        "/path/to/mcp-hello-world-ts/dist/index.js"
+      ],
+      "env": {
+        "GREETING_PREFIX": "你好"
+      }
+    }
+  }
+}
+```
+
+## 环境变量配置示例
+
+本项目演示了两种配置环境变量的方式：
+
+### 1. 使用 `.env` 文件（本地开发推荐）
+
+在项目根目录下创建 `.env` 文件，你可以配置自定义的问候语前缀：
+
+```env
+GREETING_PREFIX="你好"
+```
+
+服务端在初始化时会调用 `dotenv` 加载 `.env` 文件，你可以通过 `say_greeting` 工具来验证配置是否生效。
+
+### 2. 在 Claude Desktop 中直接配置
+
+如果你在 Claude Desktop 中使用此项目，可以在配置文件的 `env` 字段中注入环境变量：
+
+```json
+{
+  "mcpServers": {
+    "stdio-node-demo": {
+      "command": "node",
+      "args": [
+        "/path/to/mcp-hello-world-ts/dist/index.js"
+      ],
+      "env": {
+        "GREETING_PREFIX": "尊敬的"
+      }
+    }
+  }
+}
+```
+
+### 3. 可用工具演示
+
+- `helloTool(message?)`: 回显消息或返回默认问候语。如果提供了 message 参数，则回显该消息；否则返回 "Hello, World!"。
+- `add_numbers(a, b)`: 基础数值加法，将两个数字相加并返回结果。
+- `say_greeting(name)`: 演示从环境变量获取前缀并拼接姓名。从环境变量 `GREETING_PREFIX` 读取前缀（默认为 "Hello"），然后与提供的姓名拼接。
+
+### 4. 安全建议
+
+- **不要提交 `.env`**：敏感信息（如 API Key）应仅存在于本地 `.env` 中，本项目已将其加入 `.gitignore`。
+- **配置模板**：参考 `.env.example` 创建你自己的本地配置。
+
+## 使用 with Claude Desktop
+
+你可以配置 Claude Desktop 或任何 MCP 客户端来使用此服务器作为插件/工具，通过指定启动 MCP 服务器的命令。
+
+### 配置示例
+
+#### 使用 npm 包（推荐）
+
+如果你通过 npm 安装了包，可以在 Claude Desktop 设置中添加以下配置：
+
+**选项 1: 使用 npx（推荐 - 适用于所有环境）**
+
+```json
+{
+  "mcpServers": {
+    "stdio-node-demo": {
+      "command": "npx",
+      "args": [
+        "stdio-node-demo"
+      ],
+      "env": {
+        "GREETING_PREFIX": "你好"
+      }
+    }
+  }
+}
+```
+
+**选项 2: 直接路径（需要完整路径）**
+
+```json
+{
+  "mcpServers": {
+    "stdio-node-demo": {
+      "command": "node",
+      "args": [
+        "/usr/local/lib/node_modules/stdio-node-demo/dist/index.js"
+      ],
+      "env": {
+        "GREETING_PREFIX": "你好"
+      }
+    }
+  }
+}
+```
+
+**注意：** 根据你的系统调整路径：
+- **macOS/Linux (全局安装):** `/usr/local/lib/node_modules/stdio-node-demo/dist/index.js`
+- **Windows (全局安装):** `%APPDATA%\\npm\\node_modules\\stdio-node-demo\\dist\\index.js`
+- **本地安装:** `./node_modules/stdio-node-demo/dist/index.js`
+
+#### 使用源代码
+
+如果你克隆了仓库，可以在 Claude Desktop 设置中添加以下配置：
+
+```json
+{
+  "mcpServers": {
+    "stdio-node-demo": {
+      "command": "node",
+      "args": [
+        "/path/to/mcp-hello-world-ts/dist/index.js"
+      ],
+      "env": {
+        "GREETING_PREFIX": "你好"
+      }
+    }
+  }
+}
+```
+
+- 将 `/path/to/mcp-hello-world-ts/` 替换为你克隆此仓库的完整路径。
+- 确保在启动 Claude Desktop 之前已构建项目（`npm run build`）。
+
+## 项目结构
+
+```
+.
+├── src/
+│   ├── index.ts                # 主 MCP 服务器入口点
+│   ├── resources/
+│   │   └── helloResource.ts    # MCP 资源定义
+│   └── tools/
+│       └── helloTool.ts        # MCP 工具定义
+├── dist/                       # 编译后的 JS 输出
+├── package.json
+├── tsconfig.json
+├── README.md
+└── ...
+```
+
+## 自定义
+
+- 要添加新工具或资源，在 `src/resources/` 或 `src/tools/` 中创建新文件，并在 `src/index.ts` 中注册它们。
+- 修改 `helloResource.ts` 或 `helloTool.ts` 来更改问候语或添加其他功能。
+
+## License
+
+MIT License
+
+## Author
+
+- [@snoopdave](https://github.com/snoopdave)

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+import { config } from "dotenv";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerHelloResources } from "./resources/helloResource.js";
+import { registerHelloTool } from "./tools/helloTool.js";
+// 加载 .env 文件（如果存在）
+config();
+/**
+ * Main entry point for the Hello World MCP Server
+ */
+async function main() {
+    // Create the MCP Server
+    const server = new McpServer({
+        name: "HelloWorldServer",
+        version: "1.0.0",
+        description: "A minimal MCP server for Hello World!"
+    });
+    console.error('Registering Hello World modules...');
+    registerHelloResources(server);
+    registerHelloTool(server);
+    // Create the stdio transport
+    const transport = new StdioServerTransport();
+    // Connect the server to the transport
+    console.error('Hello World MCP Server starting...');
+    try {
+        await server.connect(transport);
+        console.error('Hello World MCP Server connected');
+    }
+    catch (error) {
+        console.error('Error connecting MCP server:', error);
+        process.exit(1);
+    }
+}
+// Start the server
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAC,sBAAsB,EAAC,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAC,iBAAiB,EAAC,MAAM,sBAAsB,CAAC;AAEvD,mBAAmB;AACnB,MAAM,EAAE,CAAC;AAGT;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,wBAAwB;IACxB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,uCAAuC;KACrD,CAAC,CAAC;IAEH,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAEpD,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE1B,6BAA6B;IAC7B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,sCAAsC;IACtC,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACpD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;QACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,mBAAmB;AACnB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/integration.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/integration.test.js

@@ -0,0 +1,70 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import path from 'path';
+import { beforeAll, expect, test } from '@jest/globals';
+const projectRoot = process.cwd();
+// Setup and teardown
+let client;
+let transport;
+beforeAll(async () => {
+    // Calculate the correct path to the compiled server
+    const serverPath = path.join(projectRoot, "dist", "index.js");
+    console.log(`Looking for server at: ${serverPath}`);
+    // Create the client with the stdio transport to spawn the server
+    transport = new StdioClientTransport({
+        command: "node",
+        args: [serverPath],
+    });
+    client = new Client({
+        name: "HelloWorldTestClient",
+        version: "1.0.0"
+    });
+    try {
+        await client.connect(transport);
+        console.log("Client connected to Hello World MCP server!");
+    }
+    catch (err) {
+        console.error("Error connecting client to server:", err);
+        throw err;
+    }
+});
+// In your test, make sure you use the right method names
+test('Call hello tool with no arguments', async () => {
+    const response = await client.callTool({
+        name: "helloTool",
+        arguments: {}
+    });
+    expect(response.content[0].text).toBe('Hello, World!');
+});
+test('Call hello tool with a message', async () => {
+    const response = await client.callTool({
+        name: "helloTool",
+        arguments: {
+            message: "Hello from the test suite!"
+        }
+    });
+    expect(response.content[0].text).toBe('You said: Hello from the test suite!');
+});
+test('Navigate to available resources', async () => {
+    // First list available resources
+    const listResponse = await client.readResource({
+        uri: 'hello://list'
+    });
+    // Check if resources exist
+    expect(listResponse.resources).toBeDefined();
+    // Extract resource URIs from the response
+    const resources = listResponse.resources?.map(r => r.uri) || [];
+    console.log("Available resources:", resources);
+    // Verify resources count
+    expect(resources.length).toBeGreaterThan(0);
+    // Verify expected resources are present
+    expect(resources).toContain('hello://greeting');
+    expect(resources).toContain('hello://info');
+    expect(resources).toContain('hello://list');
+    // Verify contents exist
+    expect(listResponse.contents).toBeDefined();
+    expect(listResponse.contents.length).toBeGreaterThan(0);
+    // Check that the text contains information about available resources
+    expect(listResponse.contents[0].text).toContain('Available resources');
+});
+//# sourceMappingURL=integration.test.js.map

package/dist/integration.test.js.map

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

package/dist/resources/helloResource.d.ts

@@ -0,0 +1,5 @@
+import { type McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Register Hello World resources
+ */
+export declare function registerHelloResources(server: McpServer): void;

package/dist/resources/helloResource.js

@@ -0,0 +1,72 @@
+import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Available resources in the Hello World server
+ */
+const HELLO_RESOURCES = [
+    {
+        uri: 'hello://greeting',
+        name: 'Hello World Greeting',
+        description: 'A simple greeting message',
+        mimeType: 'text/plain',
+    },
+    {
+        uri: 'hello://info',
+        name: 'Hello World Info',
+        description: 'Information about the Hello World server',
+        mimeType: 'text/plain',
+    },
+    {
+        uri: 'hello://list',
+        name: 'Resource List',
+        description: 'List of all available resources',
+        mimeType: 'text/plain',
+    }
+];
+/**
+ * Register Hello World resources
+ */
+export function registerHelloResources(server) {
+    console.error('Registering Hello World resources...');
+    // Define a list function for the list resource
+    const listFunction = () => ({
+        resources: HELLO_RESOURCES
+    });
+    // Create a properly typed undefined for the callback
+    const emptyList = undefined;
+    // Register the list resource separately for clarity
+    server.resource('HelloWorldList', new ResourceTemplate('hello://list', { list: listFunction }), async () => {
+        console.error('MCP Server: List resource handler called');
+        return {
+            resources: HELLO_RESOURCES,
+            contents: [{
+                    uri: 'hello://list',
+                    text: 'Available resources: hello://greeting, hello://info, hello://list',
+                    mimeType: 'text/plain',
+                }]
+        };
+    });
+    // Register the greeting resource
+    server.resource('HelloWorldGreeting', new ResourceTemplate('hello://greeting', { list: emptyList }), async () => {
+        console.error('MCP Server: Greeting resource handler called');
+        return {
+            contents: [{
+                    uri: 'hello://greeting',
+                    text: 'Hello, World!',
+                    mimeType: 'text/plain',
+                }]
+        };
+    });
+    // Register the info resource
+    server.resource('HelloWorldInfo', new ResourceTemplate('hello://info', { list: emptyList }), async () => {
+        console.error('MCP Server: Info resource handler called');
+        return {
+            contents: [{
+                    uri: 'hello://info',
+                    text: 'This is a Hello World MCP Server for demonstration purposes.',
+                    mimeType: 'text/plain',
+                }]
+        };
+    });
+    console.error('Hello World resources registered successfully');
+}
+//# sourceMappingURL=helloResource.js.map

package/dist/resources/helloResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helloResource.js","sourceRoot":"","sources":["../../src/resources/helloResource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,gBAAgB,EAA8B,MAAM,yCAAyC,CAAC;AAGvH;;GAEG;AACH,MAAM,eAAe,GAAG;IACtB;QACE,GAAG,EAAE,kBAAkB;QACvB,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,2BAA2B;QACxC,QAAQ,EAAE,YAAY;KACvB;IACD;QACE,GAAG,EAAE,cAAc;QACnB,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,0CAA0C;QACvD,QAAQ,EAAE,YAAY;KACvB;IACD;QACE,GAAG,EAAE,cAAc;QACnB,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,iCAAiC;QAC9C,QAAQ,EAAE,YAAY;KACvB;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAEtD,+CAA+C;IAC/C,MAAM,YAAY,GAA0B,GAAG,EAAE,CAAC,CAAC;QACjD,SAAS,EAAE,eAAe;KAC3B,CAAC,CAAC;IAEH,qDAAqD;IACrD,MAAM,SAAS,GAAG,SAA6C,CAAC;IAEhE,oDAAoD;IACpD,MAAM,CAAC,QAAQ,CACb,gBAAgB,EAChB,IAAI,gBAAgB,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,EAC5D,KAAK,IAAI,EAAE;QACT,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC1D,OAAO;YACL,SAAS,EAAE,eAAe;YAC1B,QAAQ,EAAE,CAAC;oBACT,GAAG,EAAE,cAAc;oBACnB,IAAI,EAAE,mEAAmE;oBACzE,QAAQ,EAAE,YAAY;iBACvB,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,iCAAiC;IACjC,MAAM,CAAC,QAAQ,CACb,oBAAoB,EACpB,IAAI,gBAAgB,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAC7D,KAAK,IAAI,EAAE;QACT,OAAO,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAC9D,OAAO;YACL,QAAQ,EAAE,CAAC;oBACT,GAAG,EAAE,kBAAkB;oBACvB,IAAI,EAAE,eAAe;oBACrB,QAAQ,EAAE,YAAY;iBACvB,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,6BAA6B;IAC7B,MAAM,CAAC,QAAQ,CACb,gBAAgB,EAChB,IAAI,gBAAgB,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EACzD,KAAK,IAAI,EAAE;QACT,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC1D,OAAO;YACL,QAAQ,EAAE,CAAC;oBACT,GAAG,EAAE,cAAc;oBACnB,IAAI,EAAE,8DAA8D;oBACpE,QAAQ,EAAE,YAAY;iBACvB,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;AACjE,CAAC"}

package/dist/tools/helloTool.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register the Hello World tools
+ */
+export declare function registerHelloTool(server: McpServer): void;

package/dist/tools/helloTool.js

@@ -0,0 +1,92 @@
+import { z } from "zod";
+/**
+ * Register the Hello World tools
+ */
+export function registerHelloTool(server) {
+    console.error('Registering Hello World tools...');
+    // Tool to echo a message or respond with "Hello, World!"
+    server.tool("helloTool", {
+        message: z.string().optional().describe("Message to echo back. If not provided, returns a default greeting.")
+    }, async ({ message }) => {
+        try {
+            const responseMessage = message ? `You said: ${message}` : "Hello, World!";
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: responseMessage
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error in hello tool: ${error instanceof Error ? error.message : String(error)}`
+                    }
+                ],
+                isError: true
+            };
+        }
+    });
+    // Tool to add two numbers
+    server.tool("add_numbers", {
+        a: z.number().describe("第一个加数"),
+        b: z.number().describe("第二个加数")
+    }, async ({ a, b }) => {
+        try {
+            const result = a + b;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `计算结果是: ${result}`
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error in add_numbers tool: ${error instanceof Error ? error.message : String(error)}`
+                    }
+                ],
+                isError: true
+            };
+        }
+    });
+    // Tool to say greeting with environment variable support
+    server.tool("say_greeting", {
+        name: z.string().describe("用户的姓名")
+    }, async ({ name }) => {
+        try {
+            // 从环境变量中读取前缀，如果没有则默认为 "Hello"
+            const prefix = process.env.GREETING_PREFIX || "Hello";
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `${prefix}, ${name}!`
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error in say_greeting tool: ${error instanceof Error ? error.message : String(error)}`
+                    }
+                ],
+                isError: true
+            };
+        }
+    });
+    console.error('Hello World tools registered successfully');
+}
+//# sourceMappingURL=helloTool.js.map

package/dist/tools/helloTool.js.map

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

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "stdio-node-demo",
+  "version": "1.0.2",
+  "description": "Model Context Protocol server demo using stdio transport (Node.js)",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "stdio-node-demo": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "test": "jest",
+    "clean": "rm -rf dist/*",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "stdio",
+    "node",
+    "demo",
+    "llm",
+    "openctx",
+    "model-context-protocol",
+    "claude",
+    "mcp-server"
+  ],
+  "author": "Dave Johnson",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.9.0",
+    "dotenv": "^16.4.5",
+    "zod": "^3.24.3"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.11",
+    "@types/node": "^20.10.5",
+    "@typescript-eslint/eslint-plugin": "^6.15.0",
+    "@typescript-eslint/parser": "^6.15.0",
+    "eslint": "^8.56.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.1.1",
+    "ts-jest": "^29.3.4",
+    "ts-node": "^10.9.2",
+    "tsx": "^4.19.4",
+    "typescript": "^5.3.3"
+  }
+}