Random Number MCP Server

🚀 隨機數 MCP 服務器

本項目實現了一個簡易的模型上下文協議（MCP）服務器，提供了一個藉助 random.org API 生成隨機數的工具，為隨機數生成提供了便捷途徑。

🚀 快速開始

先決條件

• 已安裝 Node.js 和 npm。
• 擁有一個 MCP 客戶端，例如 Claude 桌面應用程序。

項目設置

1. 克隆倉庫

   git clone [repository_url]
   cd [project_directory]
   

2. 安裝依賴項

   npm install
   

服務器配置

服務器通過 cline_mcp_settings.json 文件進行配置，需為該服務器添加一個條目，指定運行它的命令：

{
  "mcpServers": {
    "random-number": {
      "command": "node",
      "args": ["[path/to/index.js]"],
      "env": {}
    }
  }
}

請將 [path/to/index.js] 替換為實際的 index.js 文件路徑（通常在運行 npm run build 後位於 build 或 dist 目錄中）。

運行服務器

1. 構建服務器

   npm run build
   

2. 啟動服務器（這通常由 MCP 客戶端配置後自動完成）。

✨ 主要特性

• MCP 概念演示：該服務器展示了 MCP 的基本概念，涵蓋設置 MCP 服務器、定義和實現工具、集成外部 API 以及配置服務器以供 MCP 客戶端使用等方面。
• 隨機數生成：藉助 random.org API 生成真正的隨機數，且基本使用無需 API 密鑰。

📚 詳細文檔

API

此服務器運用 random.org API 生成真正的隨機數，基本使用無需 API 密鑰。

MCP 服務器實現

服務器在 index.ts 中實現，並使用 @modelcontextprotocol/sdk 處理 MCP 通信。

工具：get_random_number

該工具可從 random.org API 獲取一個隨機整數。

• 輸入參數：
  • max（可選）：指定最大值的整數（包含），默認為 100。
• 輸出：包含隨機數字的字符串。

💻 使用示例

基礎用法

一旦服務器運行並配置好，您就可以通過 MCP 客戶端使用 get_random_number 工具。例如，您可以在 MCP 客戶端中調用該工具獲取隨機數。