使用说明

项目简介

本项目 'SmallCloud MCP Server Demo' 是一个基于 Model Context Protocol (MCP) 协议的演示服务器实现，使用了 Anthropic 提供的 MCP SDK。它旨在帮助开发者理解 MCP 服务器的基本结构和功能，并展示如何将工具集成到 LLM 应用中。

请注意，这是一个演示项目，功能较为基础，仅包含一个简单的 'get_hello' 工具。 它主要用于学习和测试 MCP 协议的集成，不适合在生产环境中使用。

主要功能点

工具注册与执行: 演示了如何注册和提供工具 ('get_hello')，允许 LLM 客户端通过 MCP 协议调用这些工具。
基于 Stdio 的传输: 使用标准的 Stdio (标准输入输出) 作为 MCP 服务器与客户端之间的通信通道。
简单的请求处理: 实现了 'list_tools' 和 'call_tool' 两种 MCP 核心请求的处理逻辑。
能力声明: 声明了服务器提供的能力 (tools)。

安装步骤

克隆仓库:

git clone https://github.com/MCP-Mirror/SmallCloudCo_smallcloud-mcp-server.git
cd SmallCloudCo_smallcloud-mcp-server

安装依赖: 确保你已安装 Node.js (推荐版本 18 或更高) 和 npm。然后在项目目录下运行：
```
npm install
```

服务器配置

要让 MCP 客户端（例如 Claude Desktop）连接到此服务器，你需要配置客户端以指定服务器的启动命令和参数。以下是针对 Claude Desktop (MacOS) 的配置示例，你需要将这段 JSON 配置添加到 '~/Library/Application Support/Claude/claude_desktop_config.json' 文件中（如果文件不存在则创建）：

{
  "mcpServers": {
    "smallcloud-mcp-server": {  // 服务器名称，可以自定义
      "command": "/opt/homebrew/bin/node",  // 启动服务器的命令，这里假设你的 node 可执行文件路径为 /opt/homebrew/bin/node，请根据实际情况修改
      "args": [
        "~/Git/smallcloud-mcp-server/index.js" // 启动命令的参数，指向服务器入口文件 index.js 的路径，请务必修改为你的实际仓库路径
      ]
    }
  }
}

配置说明:

'"smallcloud-mcp-server"': 这是你为该 MCP 服务器定义的名称，在 Claude Desktop 中用于标识和选择该服务器。你可以自定义这个名称。
'"command"': 指定启动 MCP 服务器进程的命令。通常是 Node.js 的可执行文件路径。 '/opt/homebrew/bin/node' 是 Homebrew 安装的 Node.js 的常见路径，但你需要根据你的 Node.js 安装位置进行调整。你可以通过在终端运行 'which node' 命令来查找 Node.js 的路径。
'"args"': 一个字符串数组，包含了传递给启动命令的参数。这里只有一个参数，即 'index.js' 文件的路径。 请务必将 '~/Git/smallcloud-mcp-server/index.js' 替换为你克隆仓库后 'index.js' 文件在你电脑上的实际完整路径。 例如，如果你的仓库克隆在 '/Users/yourusername/Documents/my-mcp-server' 目录下，那么路径应该类似于 '/Users/yourusername/Documents/my-mcp-server/index.js'。

Windows 用户注意: Windows 系统的命令路径格式可能不同，并且可能需要调整命令和参数的写法。

基本使用方法

启动服务器: 在项目根目录下，运行以下命令启动 MCP 服务器：
```
node index.js
```
服务器启动后，你会在终端看到类似 'Server connected and running' 的日志信息。
配置 MCP 客户端: 根据你的 MCP 客户端（例如 Claude Desktop）的文档，配置连接到该 MCP 服务器。你需要提供在 'claude_desktop_config.json' 中配置的服务器名称 ('smallcloud-mcp-server')，客户端会根据配置的命令和参数尝试连接到服务器。
使用工具: 一旦客户端成功连接到服务器，你就可以在客户端中调用服务器提供的工具。例如，在 Claude Desktop 中，你可能会在对话中使用 '@工具名' 的方式来触发工具调用。本示例服务器提供了一个名为 'get_hello' 的工具，你可以尝试在客户端中使用它。 'get_hello' 工具接受 'name' 和 'language' 两个参数，例如，你可以尝试指示 Claude 调用 'get_hello' 工具并传递参数 'name="Claude", language="fr"'。

请注意: 由于这是一个简单的演示服务器，只提供了一个非常基础的 'get_hello' 工具。实际使用中，你需要根据你的需求扩展服务器的功能，添加更多有用的工具和资源。

关键词