🚀 SmallCloud MCP 服务器 Demo

SmallCloud MCP 服务器是一个使用 Anthropic 的 MCP 协议 SDK 构建的小型服务器示例，适用于 Claude Desktop 和其他 MCP 主机。本 Demo 为 Mac OS 系统演示版本，Windows 系统可能需小调整。若希望 MCP 解决方案能被复用，建议创建包而非仅提供 index.js 文件。更多 AI/LLM/Coding 资源，可访问 https://smallcloud.co。

🚀 快速开始

先决条件

• Node.js（推荐使用 18 或更高版本）# 通过 homebrew 安装在此示例中
• npm

安装

1. 克隆仓库：

   git clone https://github.com/your-org/smallcloud-mcp-server.git
   cd smallcloud-mcp-server
   

2. 安装依赖项：

   npm install
   

使用方法

运行服务器：

node index.js

Claude Desktop 配置（MacOS）

要在 MacOS 上使 MCP 服务器在 Claude Desktop 中显示，请将以下内容添加到您的 ~/Library/Application Support/Claude/claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "smallcloud-mcp-server": {
      "command": "/opt/homebrew/bin/node",
      "args": [
        "~/Git/smallcloud-mcp-server/index.js"
      ]
    }
  }
}

⚠️ 重要提示

根据您的实际仓库位置调整 index.js 的路径。

可用工具

当前服务器包含一个演示工具：

• get_hello：返回一条消息“Hello, World!”

📦 安装指南

1. 克隆仓库：

   git clone https://github.com/your-org/smallcloud-mcp-server.git
   cd smallcloud-mcp-server
   

2. 安装依赖项：

   npm install
   

💻 使用示例

基础用法

运行服务器：

node index.js

高级用法（Claude Desktop 配置）

要在 MacOS 上使 MCP 服务器在 Claude Desktop 中显示，请将以下内容添加到您的 ~/Library/Application Support/Claude/claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "smallcloud-mcp-server": {
      "command": "/opt/homebrew/bin/node",
      "args": [
        "~/Git/smallcloud-mcp-server/index.js"
      ]
    }
  }
}

📚 详细文档

开发

运行测试

要运行测试套件：

npm test

当前的测试套件检查以下内容：

• 服务器启动
• 工具列表功能

项目结构

smallcloud-mcp-server/
│
├── index.js          # 主服务器实现，用于 Claude Desktop。请参见“Claude Desktop 配置（MacOS）”部分
└── test/
    └── server.test.js # 服务器测试套件

贡献

1. 叉取仓库
2. 创建功能分支（git checkout -b feature/AmazingFeature）
3. 提交您的更改（git commit -m 'Add some AmazingFeature'）
4. 推送到分支（git push origin feature/AmazingFeature）
5. 打开 Pull Request

📄 许可证

[在此处指定许可证]

联系方式

[填写您的联系方式或项目维护人员信息]