mcpField
S
stelaspace-mcp

stelaspace-mcp

本地服务
github.com/StelaSpace云与基础设施019 周前更新
代码仓库

关于 stelaspace-mcp

stelaspace-mcp 是供 Claude Code 和 Codex 使用的本地 MCP 服务，可将本机 HTML 文件发布到 StelaSpace。它按路径读取文件并上传字节，适合发布较大的报告和仪表板。

主要功能

  1. 01按本机路径读取 HTML 文件
  2. 02发布文件并返回永久链接
  3. 03复用 slug 发布新版本
  4. 04列出团队空间和文档

适用场景

  1. 01发布 AI 生成的 HTML 报告
  2. 02分享仪表板或文档链接
  3. 03查看团队空间中的文档

MCP 相关

它作为本地 MCP 服务向 Claude Code 和 Codex 提供发布文件、列出空间和列出文档的工具，并通过 StelaSpace API 上传 HTML 文件。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "stelaspace-stelaspace": {
      "command": "npx",
      "args": [
        "-y",
        "stelaspace-mcp"
      ],
      "env": {
        "STELASPACE_API_KEY": "<STELASPACE_API_KEY>"
      }
    }
  }
}
启动命令npx -y stelaspace-mcp
需要配置的环境变量
STELASPACE_API_KEY密钥StelaSpace API key (starts with ss_sk_) — create one at stelaspace.com under Settings → API Keys

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmstelaspace-mcp1.0.3

工具

3

收录的工具列表 · 更新于 2 周前

参数类型必填说明
pathstring是此计算机上 .html/.htm 文件的路径（绝对路径，或相对于 MCP 服务工作目录的路径）。
slugstring否文档 slug。重用现有 slug 可发布新版本；省略则自动生成。
tagsarray否用于整理和搜索的可选标签。
titlestring否文档标题。默认为 HTML <title> 标签。
spaceSlugstring是目标空间的 slug — 调用 list_spaces 查找有效的 slug。
visibilityenum否public = 任何拥有链接的人；private = 仅团队成员。默认为 private。public | private

详细介绍

stelaspace-mcp

stelaspace-mcp MCP server

一个本地 MCP 服务，可让使用本地文件的编码 Agent（Claude Code 和 Codex）将 HTML 文件发布到 StelaSpace。

它在你的设备上运行，因此可以直接按路径从磁盘读取 HTML 文件，并通过 StelaSpace API 上传文件字节。这使它能够发布大型（1 MB 以上）报告和仪表盘；如果将文件内容作为工具参数传递，则会受模型输出大小限制。

不支持使用 Claude Desktop（聊天）进行发布：它的沙盒无法与本地 MCP 服务共享文件，因此无法上传本地报告。请使用 Claude Code 或 Codex，Agent 会将报告生成到磁盘，并直接发布。

工具

  • publish_file — { path, spaceSlug, title?, slug?, tags?, visibility? } → 读取文件并返回其永久 URL。重复使用 slug 会发布新版本。
  • list_spaces — 列出团队中的空间。
  • list_documents — { spaceSlug, query? } — 列出空间中的文档。

设置

从 StelaSpace → Settings → API Keys 获取 API 密钥（以 ss_sk_ 开头）。

Claude Code
claude mcp add stelaspace --scope user \
  --env STELASPACE_API_KEY=ss_sk_your_key \
  -- npx -y stelaspace-mcp
Codex

~/.codex/config.toml：

[mcp_servers.stelaspace]
command = "npx"
args = ["-y", "stelaspace-mcp"]
env = { STELASPACE_API_KEY = "ss_sk_your_key" }

然后让 Agent 生成并发布报告，例如： “生成销售仪表盘，并将 HTML 作为公开内容发布到我的 reports 空间。”

环境

  • STELASPACE_API_KEY（必需）— 你的 ss_sk_ 密钥。
  • STELASPACE_API_URL（可选）— 覆盖 API 端点。默认值为 https://stelaspace.com；大多数用户无需设置此项。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。