Typeship

Name: Typeship
Author: typeship.dev

远程服务

typeship.dev开发工具04 周前更新

代码仓库访问官网

关于 Typeship

Typeship 的 MCP 服务供 AI Agent 查询并调用 Typeship API，用于解析和诊断 OpenAPI 或 GraphQL 规范，并维护选定的 SDK、CLI 和 MCP 目标。

主要功能

01搜索和读取文档
02执行 API 操作
03校验带类型的操作参数
04筛选返回字段
05只读模式与工具选择

适用场景

01执行操作前查找 API 指引
02解析或诊断 API 规范
03维护选定的生成目标

MCP 相关

通过发现工具和 execute 向 MCP 客户端提供 Typeship API 文档与操作。支持本地 stdio 和托管连接，并可启用只读模式。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://typeship.dev/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http dev-typeship-typeship https://typeship.dev/mcp

Cursor.cursor/mcp.json{"mcpServers":{"dev-typeship-typeship":{"type":"http","url":"https://typeship.dev/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"dev-typeship-typeship":{"type":"http","url":"https://typeship.dev/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"dev-typeship-typeship":{"type":"http","url":"https://typeship.dev/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"dev-typeship-typeship":{"serverUrl":"https://typeship.dev/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址

Streamable HTTPhttps://typeship.dev/mcp

Streamable HTTPhttps://typeship.dev/mcp/public

Streamable HTTPhttps://typeship.dev/mcp/readonly

安装包

npm@typeship-ax/mcp0.23.0stdio

工具

详细介绍

@typeship-ax/mcp

Typeship API 的 MCP 服务。API 参考

解析 OpenAPI 或 GraphQL 规范，对其进行诊断，并让每个选定的 CLI、MCP 和 SDK 目标保持最新。

安装

MCP 客户端通过 npx 启动服务，因此无需单独安装（参见连接 MCP 客户端）。如需全局安装 typeship-mcp 命令：

npm install --global @typeship-ax/[email protected]

需要 Node.js 20+。

连接 MCP 客户端

通过 MCP 客户端的环境变量或密钥设置提供 TYPESHIP_TOKEN。请勿将凭据值放入 URL 或命令参数中。

本地

Claude Code：claude mcp add typeship -- npx -y --package @typeship-ax/mcp typeship-mcp
Codex：codex mcp add typeship -- npx -y --package @typeship-ax/mcp typeship-mcp
在 VS Code 中安装

本地 · 只读

Claude Code：claude mcp add typeship-readonly -- npx -y --package @typeship-ax/mcp typeship-mcp --read-only
Codex：codex mcp add typeship-readonly -- npx -y --package @typeship-ax/mcp typeship-mcp --read-only
在 VS Code 中安装

托管

Claude Code：claude mcp add --transport http typeship https://typeship.dev/mcp
Codex：codex mcp add typeship --url https://typeship.dev/mcp
在 VS Code 中安装

托管 · 只读

Claude Code：claude mcp add --transport http typeship-readonly https://typeship.dev/mcp/readonly
Codex：codex mcp add typeship-readonly --url https://typeship.dev/mcp/readonly
在 VS Code 中安装

其他客户端

在客户端的 MCP 配置中添加服务条目。对于 Cursor，将其合并到 .cursor/mcp.json 中的 mcpServers，然后在 Cursor 的 MCP 设置中启用该服务：

{
  "mcpServers": {
    "typeship": {
      "command": "npx",
      "args": [
        "-y",
        "--package",
        "@typeship-ax/mcp",
        "typeship-mcp"
      ],
      "env": {
        "TYPESHIP_TOKEN": "replace-with-your-credential"
      }
    }
  }
}

如果 MCP 客户端提供密钥存储，请使用它替换凭据占位符。服务从其环境中读取 TYPESHIP_TOKEN；凭据绝不能放在命令参数中。

该服务支持 MCP 2025-11-25 和 2026-07-28，并会自动选择版本，因此客户端无需设置协议。使用 Claude Code 注册后，运行 claude mcp list 即可查看连接。

工具

该服务通过 stdio 运行，无运行时依赖，并提供精简的发现接口：search_docs、read_docs 和 execute。执行操作前先读取它，以了解其参数、示例和安全分类。

工具输入架构来自 OpenAPI 规范，因此 Agent 可以看到真实的参数类型和必填字段。在请求到达 API 前，参数会经过检查（未知或类型错误的参数会作为一个 isError 结果返回，不会有参数被丢弃）；每个工具都接受 fields，以仅保留所需的结果键；错误会包含稳定的 code 和 next_steps。

将 --read-only 添加到 args（或设置 TYPESHIP_MCP_READ_ONLY=1），即可让服务无法写入；使用 --tools projects,specs（或 TYPESHIP_MCP_TOOLS）可仅公开部分工具；设置 TYPESHIP_MCP_MAX_RESULT_CHARS 可更改结果大小上限（64,000）。

由 Typeship 根据 OpenAPI 规范生成。

支持 Markdown

登录后评论