MCP Hello World

🚀 MCP 你好

mcp-hello-world 是一款用於測試和驗證 MCP 協議實現的工具。它提供簡潔接口，讓開發者能發送請求並接收響應，以此驗證 MCP 實現的正確性。

🚀 快速開始

啟動 MCP 服務器：

npx mcp-hello-world

這會啟動一個 MCP 服務器，監聽標準輸入和輸出。

✨ 主要特性

資源

• hello://world：靜態的“你好，世界”資源，通過 resources/get 方法獲取，無參數，返回 { data: '你好，世界！' }。
• greeting://{name}：動態的問候資源，使用 resources/get 方法，名稱包含在 URI 中（如 greeting://Bob），返回 { data: '你好，{name}！' }。

工具

• echo：通過 tools/invoke 方法，回顯輸入消息並在前面加上“你好 ”，參數為 { name: 'echo', parameters: { message: string } }，返回 { content: [{ type: 'text', text: '你好 {message}' }] }。
• debug：使用 tools/invoke 方法，列出服務器上註冊的所有 MCP 方法定義，參數為 { name: 'debug', parameters: {} }，返回包含所有已註冊資源、工具和提示的 JSON 結構。

提示

• helpful-assistant：使用 prompts/get 方法獲取基本的助手提示定義，無參數，返回包含 system 和 user 角色的提示 JSON 結構。

📦 安裝指南

你可以通過 npm 來安裝 mcp-hello-world：

npm install mcp-hello-world

💻 使用示例

基礎用法

創建一個客戶端來連接 MCP 服務器。例如，使用 child_process 來 spawn 一個新的進程：

const {spawn} = require('child_process');
const mcpServer = spawn('npx', ['mcp-hello-world']);

然後你可以通過這個進程的 stdio 來發送和接收 MCP 請求。

高級用法

使用標準輸入輸出

const {spawn} = require('child_process');
const mcpServer = spawn('npx', ['mcp-hello-world']);

// 發送問候請求
const request = {
    jsonrpc: '2.0',
    method: 'resources/get',
    params: ['hello://world'],
    id: 1
};

mcpServer.stdin.write(JSON.stringify(request) + '\n');

// 監聽響應
mcpServer.stdout.on('data', (data) => {
    console.log(data.toString());
});

使用 HTTP

你可以通過訪問 http://localhost:3000 來發送請求。

📚 詳細文檔

配置

默認情況下，服務器會監聽標準輸入和輸出。你也可以通過環境變量來配置一些選項：

• MCP_PORT：設置監聽的端口（默認為 3000）

📄 許可證

[此處應填寫許可證信息，例如 MIT 許可證]

貢獻者

• [你的名字] - 項目維護者

這個文檔為你提供了關於如何使用和集成 mcp-hello-world 的基本指南。如果你有任何問題或建議，請隨時與我們聯繫！