# 安装 Soma

- 类型: MCP 工具
- 说明: Drop-in RMCP runtime for provider-backed MCP tools, prompts, resources, and agent capabilities.
- 仓库: https://github.com/jmagar/soma

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "Soma" MCP 服务：
执行：claude mcp add 'ai-dinglebear-soma-rmcp' -- npx -y soma-rmcp
```

### Codex
```
请帮我安装 askskill 上的 "Soma" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.ai-dinglebear-soma-rmcp]
command = "npx"
args = ["-y","soma-rmcp"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "Soma" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"ai-dinglebear-soma-rmcp": { "command": "npx", "args": ["-y","soma-rmcp"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --env SOMA_BIN=YOUR_VALUE --env SOMA_HOME=YOUR_VALUE --env SOMA_PROVIDER_DIR=YOUR_VALUE --env SOMA_API_URL=YOUR_VALUE --env SOMA_API_KEY=YOUR_VALUE --env RUST_LOG=YOUR_VALUE --transport stdio ai-dinglebear-soma-rmcp -- npx -y soma-rmcp
```
需要环境变量：SOMA_BIN, SOMA_HOME, SOMA_PROVIDER_DIR, SOMA_API_URL, SOMA_API_KEY, RUST_LOG

### Codex
```bash
codex mcp add --env SOMA_BIN=YOUR_VALUE --env SOMA_HOME=YOUR_VALUE --env SOMA_PROVIDER_DIR=YOUR_VALUE --env SOMA_API_URL=YOUR_VALUE --env SOMA_API_KEY=YOUR_VALUE --env RUST_LOG=YOUR_VALUE ai-dinglebear-soma-rmcp -- npx -y soma-rmcp
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.ai-dinglebear-soma-rmcp]
command = "npx"
args = ["-y","soma-rmcp"]

[mcp_servers.ai-dinglebear-soma-rmcp.env]
SOMA_BIN = "YOUR_VALUE"
SOMA_HOME = "YOUR_VALUE"
SOMA_PROVIDER_DIR = "YOUR_VALUE"
SOMA_API_URL = "YOUR_VALUE"
SOMA_API_KEY = "YOUR_VALUE"
RUST_LOG = "YOUR_VALUE"
```
需要环境变量：SOMA_BIN, SOMA_HOME, SOMA_PROVIDER_DIR, SOMA_API_URL, SOMA_API_KEY, RUST_LOG

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "ai-dinglebear-soma-rmcp": {
      "command": "npx",
      "args": [
        "-y",
        "soma-rmcp"
      ],
      "env": {
        "SOMA_BIN": "YOUR_VALUE",
        "SOMA_HOME": "YOUR_VALUE",
        "SOMA_PROVIDER_DIR": "YOUR_VALUE",
        "SOMA_API_URL": "YOUR_VALUE",
        "SOMA_API_KEY": "YOUR_VALUE",
        "RUST_LOG": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=ai-dinglebear-soma-rmcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsInNvbWEtcm1jcCJdLCJlbnYiOnsiU09NQV9CSU4iOiJZT1VSX1ZBTFVFIiwiU09NQV9IT01FIjoiWU9VUl9WQUxVRSIsIlNPTUFfUFJPVklERVJfRElSIjoiWU9VUl9WQUxVRSIsIlNPTUFfQVBJX1VSTCI6IllPVVJfVkFMVUUiLCJTT01BX0FQSV9LRVkiOiJZT1VSX1ZBTFVFIiwiUlVTVF9MT0ciOiJZT1VSX1ZBTFVFIn19
需要环境变量：SOMA_BIN, SOMA_HOME, SOMA_PROVIDER_DIR, SOMA_API_URL, SOMA_API_KEY, RUST_LOG