使用说明

项目简介

Atoma SDK 服务器是一个基于Typescript构建的应用后端，它基于 Model Context Protocol (MCP) 实现了服务器功能。该项目主要目的是为了方便开发者将 Atoma SDK 的各种功能以工具的形式暴露给支持 MCP 协议的AI客户端（如 Claude、Cursor 等），使得AI应用能够更便捷地利用 Atoma 提供的能力，例如聊天补全、生成图片、创建向量嵌入等。

主要功能点

资源访问能力: 通过 SDK 提供的各种方法，MCP服务器可以作为数据资源的访问入口，虽然仓库文档中没有明确资源定义，但SDK本身封装了对后端API的访问，可以理解为通过工具间接提供了资源访问能力。
工具注册与执行: 将 Atoma SDK 中的方法（如 'chat.create', 'images.create' 等）注册为 MCP 工具，允许 AI 客户端调用这些工具来执行相应的操作。
Prompt 模板: 仓库未明确提及 Prompt 模板功能，但工具的灵活性和可配置性在一定程度上支持了定制化的 LLM 交互模式。
多种传输协议: 支持 Stdio 和 SSE (Server-Sent Events) 两种传输协议，满足不同客户端和应用场景的需求。
会话管理和能力声明: MCP 服务器负责管理客户端会话，并声明其提供的工具能力，方便客户端发现和使用。

安装步骤

安装 Node.js: 确保你的环境中安装了 Node.js v20 或更高版本。
安装 Atoma SDK: 使用 npm, pnpm, bun 或 yarn 等包管理器安装 Atoma SDK。例如使用 npm：
```
npm install atoma-sdk
```

服务器配置

MCP 服务器的配置主要是在 MCP 客户端（例如 Claude 或 Cursor）中指定服务器的启动命令和参数。以下是 Claude 和 Cursor 的配置示例，请注意，您无需修改这些 JSON 配置代码，只需将它们复制到对应的客户端配置中，并根据您的实际情况替换占位符即可。

Claude 配置示例

在 'claude_desktop_config.json' 文件中添加以下服务器定义：

{
  "mcpServers": {
    "AtomaSDK": {
      "command": "npx",
      "args": [
        "-y", "--package", "atoma-sdk",
        "--",
        "mcp", "start",
        "--bearer-auth", "YOUR_BEARER_TOKEN"
      ]
    }
  }
}

参数说明:

'command': 指定启动 MCP 服务器的命令，这里使用 'npx' 来执行本地安装的 'atoma-sdk' 包。
'args': 启动命令的参数列表：
- '-y --package atoma-sdk': 使用 'npx' 安装并执行 'atoma-sdk' 包。
- '--': 分隔 'npx' 参数和 'atoma-sdk' 命令参数。
- 'mcp start': 启动 MCP 服务器的命令。
- '--bearer-auth YOUR_BEARER_TOKEN': 重要: 设置 Bearer Token 用于 API 鉴权，请替换 'YOUR_BEARER_TOKEN' 为您实际的 Bearer Token。

Cursor 配置示例

在 Cursor 设置中，进入 'Cursor Settings > Features > MCP Servers > Add new MCP server'，并使用以下配置：

Name: 'AtomaSDK' (服务器名称，可自定义)
Type: 'command' (服务器类型为命令)

Command:

npx -y --package atoma-sdk -- mcp start --bearer-auth YOUR_BEARER_TOKEN

参数说明: 与 Claude 配置中的 'args' 参数说明一致，请务必替换 'YOUR_BEARER_TOKEN' 为您实际的 Bearer Token。

基本使用方法

启动 MCP 服务器: 根据上述配置，当你在 Claude 或 Cursor 中启用 "AtomaSDK" 这个 MCP 服务器时，客户端会自动执行配置的命令来启动服务器。
AI 客户端调用工具: 启动成功后，AI 客户端就可以通过 MCP 协议与 Atoma SDK 服务器通信，并调用服务器暴露的各种工具，例如进行聊天、生成图片等，具体工具列表和使用方式请参考 Atoma SDK 的文档。

注意: 请务必将配置文件中的 'YOUR_BEARER_TOKEN' 替换为您在 Atoma 平台获取的有效 Bearer Token，以确保服务器能够成功鉴权并正常工作。

关键词