Theneo MCP Server

MCP开发工具

提供方 atombreak

开发工具 stdio · 本地进程 API Key 社区 / 第三方 Claude DesktopClaudeCursorVS Code
查看接入方式

Theneo MCP Server 是一个通过Model Context Protocol提供API文档自动化创建、更新和发布功能的服务,适用于AI助手集成和CI/CD工作流。

一句话选型结论

按资料字段整理

Theneo MCP Server 属于开发工具类 MCP 服务器,stdio · 本地进程,API Key,可直接接入 Claude Desktop、Claude、Cursor 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式stdio · 本地进程 鉴权API Key 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 15 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量15暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

API文档TypeScript本地部署自动化AI集成开发者工具CI/CD

安装与配置

stdio · 本地进程 API Key
客户端在本机拉起子进程,数据不出本机
docker run -it --rm \

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Docker,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 15 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 15 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Theneo MCP Server当前 15 stdio · 本地进程 本地部署 有 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方atombreak上游标注的维护方 atombreak
分类开发工具本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Docker本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

30.5 KB
来自项目仓库与上游目录的原文,未做删改

Theneo MCP 服务器

Theneo SDK的模型上下文协议服务器 人工智能时代API文档的自动化支柱。

这个MCP服务器暴露了 Theneo的 API文档平台通过 模型上下文协议,允许AI助手自动创建、更新和发布API文档。

概述

Theneo MCP使任何AI助手(如Claude Desktop、VS Code Copilot、Cursor等)能够与Theneo的SDK进行交互,从而实现API文档的创建和维护的完全自动化。非常适合CI/CD流水线、AI驱动的工作流和开发者生产力工具。

主要特点

  • 💬 自然语言只需交谈——无需记忆工具名称或参数!
  • 🎯(目标) 基于名称的引用通过名称而非ID引用项目和工作区——AI会自动查找它们!
  • 🔐 企业安全多源配置,操作系统密钥链支持,秘密掩码
  • 📦(包裹/箱子) 灵活输入支持OpenAPI/Swagger文件、URL、原始文本以及Postman集合
  • 地球🌍 配置文件支持管理多个环境(开发、测试、生产)

设计选择

为什么选择SDK而不是CLI?

直接SDK集成提供了类型安全性、更好的错误处理以及无需处理shell转义问题即可访问完整的API接口。

为什么选择OS Keychain?

无需环境变量或明文文件,即可安全存储静态凭证。通过keytar实现跨平台支持。

为何支持个人资料功能?

多环境工作流(开发/预生产/生产)很常见。配置文件使得在不同环境之间轻松切换上下文,无需管理繁琐的凭据。

为什么选择MCP协议?

MCP实现了AI工具集成的标准化。一次编写,即可在Claude、VS Code Copilot、Cursor以及未来的AI助手上运行。

安装

npm(推荐)```bash

Global installation

npm install -g theneo-mcp

Verify installation

theneo-mcp --version


### Homebrew(适用于 macOS/Linux)```bash
# Add tap
brew tap theneo/theneo-mcp

# Install
brew install theneo-mcp

# Verify installation
theneo-mcp --version

Docker(注:Docker是一个用于开发、交付和运行应用程序的开源平台,可以实现应用容器化,简化应用部署过程。)```bash

Pull from Docker Hub

docker pull theneo/theneo-mcp:latest

Run with API key

docker run -it --rm \
-e THENEO_API_KEY=your_api_key \
theneo/theneo-mcp:latest


### 本地开发```bash
git clone https://github.com/atombreak/theneo-mcp.git
cd theneo-mcp
npm install
npm run build

快速入门(5分钟)

获取您的API密钥

2. 配置身份验证

选项A:OS密钥链(推荐用于本地开发)```bash
theneo-mcp creds save --profile default --apiKey YOUR_API_KEY


**选项B:环境变量**```bash
export THENEO_API_KEY=YOUR_API_KEY

3. 连接您的AI助手

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:```json
{
"mcpServers": {
"theneo": {
"command": "theneo-mcp",
"args": ["server"]
}
}
}


#### VS Code Copilot(VS代码协作者/VS代码同伴,通常简称为“VS Code 的 Copilot”)

添加到你的VS Code `settings.json`:```json
{
"chat.mcp.access": "all",
"chat.mcp.servers": {
"theneo": {
"command": "theneo-mcp",
"args": ["server"],
"env": {
"THENEO_API_KEY": "your_api_key_here"
}
}
}
}

光标

添加到光标设置(设置 → MCP):```json
{
"mcpServers": {
"theneo": {
"command": "theneo-mcp",
"args": ["server", "--profile", "default"]
}
}
}


### 4. 进行测试

在你的AI助手中,只需自然对话:```
Show me my Theneo workspaces

然后创建一个项目:```
Create a new project called "Demo API" using the Petstore OpenAPI example
from GitHub. Make it public and enable AI descriptions.


或者,如果你更倾向于明确表达:```
Use theneo_create_project with name "Demo API",
link "https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/examples/v3.0/petstore.json",
publish true, isPublic true, and descriptionGeneration "FILL"

💡 灯泡(或表示“灵感”、“想法”的符号) 专业小贴士你无需记忆工具名称或参数——只需用简单的英语描述你的需求即可!

配置

配置源与优先级

配置从多个来源加载,且具有明确的优先级(从高到低排列):

优先级 来源 使用场景 示例
1 CLI 标志 覆盖所有设置 --apiKey sk_xxx
2 环境变量 CI/CD(持续集成/持续交付),容器 THENEO_API_KEY=xxx
3 项目RC文件 项目特定设置 .theneo-mcp.yaml
4 用户配置 个人默认设置 ~/.config/theneo-mcp/config.json
5 操作系统密钥链 安全本地存储 theneo-mcp creds save
6 .env 文件 仅用于开发 .env

环境变量

变量 · 描述 · 默认值
THENEO_API_KEY 您的Theneo API密钥 必需的
THENEO_BASE_API_URL Theneo API 端点 https://api.theneo.io
THENEO_BASE_APP_URL · Theneo 网页应用 URL · https://app.theneo.io
THENEO_PROFILE · 配置文件 · default

项目配置文件

创建 .theneo-mcp.yaml 或者 .theneo-mcp.json 在你的项目根目录中:```yaml

.theneo-mcp.yaml

profile: default
baseApiUrl: https://api.theneo.io
baseAppUrl: https://app.theneo.io

Multi-environment support

profiles:
development:
profile: development

production:
profile: production


**⚠️ 安全提示**永远不要将API密钥提交到版本控制系统中!请将它们存储在密钥链或环境变量中。

### 用户配置

创建 `~/.config/theneo-mcp/config.json` (Linux/macOS) 或 `%AppData%/theneo-mcp/config.json` (Windows):```json
{
"profile": "default",
"baseApiUrl": "https://api.theneo.io",
"baseAppUrl": "https://app.theneo.io",
"profiles": {
"default": {},
"production": {}
}
}

OS 密钥链(推荐)

在您的系统密钥链中安全存储API密钥:```bash

Save API key

theneo-mcp creds save --profile default --apiKey YOUR_KEY

Remove API key

theneo-mcp creds rm --profile default

List stored profiles

theneo-mcp creds list


### 使用配置文件

轻松切换环境:```bash
# Use production profile
theneo-mcp server --profile production

# Or via environment
THENEO_PROFILE=production theneo-mcp server

可用工具

🎯(目标) 新现在你可以参考 项目 并且 工作区 由 名字 无需记住他们的ID!人工智能会自动为您查找。

1. theneo_list_workspaces

列出您账户可访问的所有工作区。

参数: 无

自然语言示例:```
Show me my Theneo workspaces

What workspaces do I have access to?

List all my Theneo workspaces


**显式工具调用(用于测试/调试):**```
Use theneo_list_workspaces

2. theneo_list_projects

列出工作区中的所有项目或跨所有工作区列出项目。您可以使用ID、密钥(slug)或名称按工作区进行过滤。返回项目名称、ID和详细信息。

参数:

  • workspaceId (字符串,可选):用于过滤项目的Workspace ID
  • workspaceKey (字符串,可选):用于过滤项目的工区密钥/标识符
  • workspaceName (字符串,可选):用于过滤项目的工区名称

自然语言示例:```
Show me all my projects

List all projects in the "Engineering" workspace

What projects do I have in my "Production" workspace?


**显式工具调用(用于测试/调试):**```
Use theneo_list_projects

3. theneo_create_project

创建一个带有可选规范导入和AI生成功能的新API文档项目。您可以按ID、密钥(slug)或名称指定工作区。

参数:

  • name (字符串,必填):项目名称
  • workspaceKey (字符串,可选):工作区代号
  • workspaceId (字符串,可选):工作区ID
  • workspaceName (字符串,可选):工作区名称
  • publish (布尔值,可选):立即发布
  • isPublic (布尔值,可选):使项目公开
  • descriptionGeneration (枚举,可选): FILL · OVERWRITE · NO_GENERATION
  • 数据来源 (选择一个):
  • file (字符串):本地OpenAPI/Swagger文件的路径
  • link (字符串):OpenAPI/Swagger 规范的 URL
  • text (字符串): 原始 OpenAPI/Swagger 规范
  • postmanApiKey + postmanCollectionIds从Postman导入

自然语言示例:```
Create a new project called "Payment API" in the "Engineering" workspace from
this OpenAPI spec: https://example.com/openapi.json and make it public with AI descriptions

I need to create API documentation for my REST API in my "Production" workspace.
The spec is at ./specs/api.yaml. Name it "User Service API" and enable AI descriptions.

Can you create a Theneo project named "Stripe Clone" in the "Public APIs" workspace
using the Petstore example from GitHub? Make it public and publish it immediately.


**显式工具调用(用于测试/调试):**```
Use theneo_create_project with:
- name: "My API"
- link: "https://example.com/openapi.json"
- publish: true
- isPublic: true
- descriptionGeneration: "FILL"

示例回复:```json
{
"projectId": "proj_abc123xyz",
"publishData": {
"projectKey": "my-api",
"companySlug": "acme-corp",
"publishedPageUrl": "https://app.theneo.io/acme-corp/my-api",
"baseUrlRequired": false
}
}


### 4. `theneo_import_project_document`

在现有项目中导入或更新API文档。 **你可以通过名称而不是ID来引用项目和工作区**。

**参数:**

- `projectId` (字符串,可选):目标项目ID
- `projectName` (字符串,可选):目标项目名称(可作为projectId的替代)
- `workspaceId` (字符串,可选):工作区ID(在使用projectName时很有帮助)
- `workspaceKey` (字符串,可选):工作区密钥/别名(在使用 projectName 时很有帮助)
- `workspaceName` (字符串,可选):工作区名称(在使用 projectName 时很有帮助)
- `publish` (布尔值,可选):导入后发布
- `importOption` (枚举,可选): `MERGE` · `OVERWRITE` · `ENDPOINTS_ONLY`
- **数据来源** (与create_project相同,一个必需)

**自然语言示例:**```
Update the "Payment API" project in my "Engineering" workspace with the latest
spec from ./api/openapi.yaml and merge it with existing content

I need to import a new version into the "User Service" project in the "Production"
workspace. Use this URL: https://api.example.com/openapi.json and overwrite everything.

Import the updated Postman collection into "My Company API" in the "Public APIs"
workspace and publish it with merge.

明确的工具调用(用于测试/调试):```
Use theneo_import_project_document with:
- projectId: "proj_123"
- file: "./openapi.json"
- importOption: "MERGE"
- publish: true


### 5. `theneo_publish_project`

发布一个项目以使其上线运行。 **你可以通过名称来引用项目和工作区**可选地指定要发布的版本。

**参数:**

- `projectId` (字符串,可选):项目ID
- `projectName` (字符串,可选):项目名称(可作为projectId的替代)
- `workspaceId` (字符串,可选):工作区ID(在使用projectName时有所帮助)
- `workspaceKey` (字符串,可选):工作区密钥/标识符(在使用 projectName 时很有帮助)
- `workspaceName` (字符串,可选):工作区名称(在使用 projectName 时很有帮助)
- `versionId` (字符串,可选):要发布的版本ID(如果未指定,则发布默认版本)

**自然语言示例:**```
Publish the "Payment API" project in my "Engineering" workspace

Make the "User Service API" in the "Production" workspace live

Publish the project called "Stripe Clone" in "Public APIs"

显式工具调用(用于测试/调试):```
Use theneo_publish_project with projectId "proj_123"


### 6. `theneo_preview_link`

获取项目的编辑器预览URL。 **你可以通过名称来引用项目和工作区**。

**参数:**

- `projectId` (字符串,可选):项目ID
- `projectName` (字符串,可选):项目名称(可作为projectId的替代)
- `workspaceId` (字符串,可选):工作区ID(在使用projectName时很有帮助)
- `workspaceKey` (字符串,可选):工作区密钥/标识符(在使用 projectName 时很有帮助)
- `workspaceName` (字符串,可选):工作区名称(在使用 projectName 时有所帮助)

**自然语言示例:**```
Get me the preview link for "Payment API" in the "Engineering" workspace

Show me where I can edit the "User Service" project in "Production"

What's the URL to view "My Company API" in the "Public APIs" workspace?

显式工具调用(用于测试/调试):```
Use theneo_preview_link for project "proj_123"


### 7. `theneo_wait_for_generation`

等待AI描述生成完成。 **你可以通过名称来引用项目和工作区**。

**参数:**

- `projectId` (字符串,可选):项目ID
- `projectName` (字符串,可选):项目名称(可作为 projectId 的替代)
- `workspaceId` (字符串,可选):工作区ID(在使用projectName时很有帮助)
- `workspaceKey` (字符串,可选):工作区密钥/别名(在使用 projectName 时很有帮助)
- `workspaceName` (字符串,可选):工作区名称(在使用 projectName 时很有帮助)
- `retryTimeMs` (数字,可选):轮询间隔(默认:2500)
- `maxWaitTimeMs` (数字,可选):最长等待时间(默认:120000)

**自然语言示例:**```
Wait for the AI to finish generating descriptions for "Payment API" in "Engineering"

Check if AI generation is complete for "User Service" in the "Production" workspace

Keep checking until the AI descriptions are done for "My Company API" in "Public APIs"

明确的工具调用(用于测试/调试):```
Use theneo_wait_for_generation for project "proj_123"


### 8. `theneo_get_generation_status`

获取项目中AI描述生成的当前状态和进度。 **你可以通过名称来引用项目和工作区**。

**参数:**

- `projectId` (字符串,可选):项目ID
- `projectName` (字符串,可选):项目名称(可替代 projectId)
- `workspaceId` (字符串,可选):工作区ID(在使用projectName时很有帮助)
- `workspaceKey` (字符串,可选):工作区密钥/标识符(在使用 projectName 时很有帮助)
- `workspaceName` (字符串,可选):工作区名称(在使用 projectName 时很有帮助)

**自然语言示例:**```
Check the AI generation status for "Payment API" in "Engineering"

What's the progress of AI description generation for "User Service"?

Show me the generation status of "My Company API" in the "Public APIs" workspace

显式工具调用(用于测试/调试):```
Use theneo_get_generation_status with projectId "proj_123"


### 9. `theneo_delete_project`

永久删除一个项目。 **你可以通过名称来引用项目和工作区**⚠️ 此操作无法撤销。

**参数:**

- `projectId` (字符串,可选):项目ID
- `projectName` (字符串,可选):项目名称(可替代projectId)
- `workspaceId` (字符串,可选):工作区ID(在使用projectName时很有帮助)
- `workspaceKey` (字符串,可选):工作区密钥/别名(在使用 projectName 时很有帮助)
- `workspaceName` (字符串,可选):工作区名称(在使用 projectName 时很有帮助)

**自然语言示例:**```
Delete the "Old API" project from my "Engineering" workspace

I need to remove the "Test Project" from the "Staging" workspace

Can you delete "Legacy API v1" in my "Production" workspace?

显式工具调用(用于测试/调试):```
Use theneo_delete_project with projectId "proj_123"


### 10. `theneo_list_project_versions`

列出特定项目的所有版本。 **你可以通过名称来引用项目和工作区**。

**参数:**

- `projectId` (字符串,可选):项目ID
- `projectName` (字符串,可选):项目名称(可替代projectId)
- `workspaceId` (字符串,可选):工作区ID(在使用projectName时很有帮助)
- `workspaceKey` (字符串,可选):工作区密钥/标识符(在使用 projectName 时很有帮助)
- `workspaceName` (字符串,可选):工作区名称(在使用 projectName 时很有帮助)

**自然语言示例:**```
Show me all versions of the "Payment API" project in "Engineering"

List versions for "User Service" in the "Production" workspace

What versions does the "My Company API" have?

明确的工具调用(用于测试/调试):```
Use theneo_list_project_versions with projectId "proj_123"


### 11. `theneo_create_project_version`

创建项目的新版本。 **你可以通过名称来引用项目和工作区**.

**参数:**

- `name` (字符串,必填): 版本名称
- `projectId` (字符串,可选):项目ID
- `projectName` (字符串,可选):项目名称(可作为projectId的替代)
- `workspaceId` (字符串,可选):工作区ID(在使用projectName时很有帮助)
- `workspaceKey` (字符串,可选):工作区密钥/别名(在使用 projectName 时很有帮助)
- `workspaceName` (字符串,可选):工作区名称(在使用 projectName 时很有帮助)
- `previousVersionId` (字符串,可选):要复制的先前版本ID
- `isNewVersion` (布尔值,可选):是否为新版本
- `isEmpty` (布尔值,可选):版本是否应为空
- `isDefault` (布尔值,可选):是否应将其设为默认版本

**自然语言示例:**```
Create a new version "v2.0" for "Payment API" in the "Engineering" workspace

Add version "2024-Q1" to the "User Service" project in "Production"

Create an empty version called "v3.0-beta" for "My Company API"

显式工具调用(用于测试/调试):```
Use theneo_create_project_version with:
- name: "v2.0"
- projectId: "proj_123"


### 12. `theneo_delete_project_version`

删除项目的特定版本。⚠️ 此操作无法撤销。

**参数:**

- `versionId` (字符串,必填):要删除的版本ID

**自然语言示例:**```
Delete version "ver_abc123" from the project

Remove the beta version with ID ver_xyz789

I need to delete version ver_old456

显式工具调用(用于测试/调试):```
Use theneo_delete_project_version with versionId "ver_123"


### 13. `theneo_add_subscriber_to_version`

添加一个电子邮件订阅者以接收特定项目版本的更新。

**参数:**

- `email` (字符串,必填):用于订阅的电子邮件地址
- `projectVersionId` (字符串,必填):项目版本ID

**自然语言示例:**```
Add john@company.com as a subscriber to version ver_abc123

Subscribe jane.doe@example.com to receive updates for version ver_xyz789

I want to add team@company.com to the subscriber list for version ver_def456

显式工具调用(用于测试/调试):```
Use theneo_add_subscriber_to_version with:
- email: "user@example.com"
- projectVersionId: "ver_123"


### 14. `theneo_export_project`

导出项目的文档。 **你可以通过名称来引用项目和工作区**。

**参数:**

- `projectId` (字符串,可选):项目ID
- `projectName` (字符串,可选):项目名称(可替代projectId)
- `workspaceId` (字符串,可选):工作区ID(在使用projectName时很有帮助)
- `workspaceKey` (字符串,可选):工作区密钥/别名(在使用 projectName 时很有帮助)
- `workspaceName` (字符串,可选):工作区名称(在使用 projectName 时有所帮助)
- `versionId` (字符串,可选):要导出的版本ID
- `dir` (字符串,可选):保存导出文件的目录
- `noGeneration` (布尔值,可选):跳过AI生成
- `shouldGetPublicViewData` (布尔值,可选):获取公共视图数据
- `openapi` (布尔值,可选):以OpenAPI格式导出

**自然语言示例:**```
Export the "Payment API" project from the "Engineering" workspace as OpenAPI

Download the documentation for "User Service" in "Production" to ./exports

Export "My Company API" with public view data

明确的工具调用(用于测试/调试):```
Use theneo_export_project with:
- projectId: "proj_123"
- openapi: true


### 15. `theneo_list_postman_collections`

列出可以使用提供的Postman API密钥访问的所有Postman集合。

**参数:**

- `postmanApiKey` Postman API密钥

**自然语言示例:**```
Show me my Postman collections using this API key: pmak_xyz123

List all Postman collections I have access to

What Postman collections are available with my API key?

显式工具调用(用于测试/调试):```
Use theneo_list_postman_collections with postmanApiKey "pmak_xyz123"


## 演示脚本(端到端)

这个5分钟的演示展示了完整的流程。您可以使用任意一种 **自然语言** 或者 **明确的工具调用**。

### 🗣️ 自然语言版本(推荐)

只需自然地与您的AI助手交谈:```
Step 1: Show me my Theneo workspaces

Step 2: Create a new project called "USPTO API Documentation" using this OpenAPI spec:
https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/examples/v3.0/uspto.json
Make it public, publish it immediately, and enable AI-generated descriptions to fill in missing content.

Step 3: Wait for the AI description generation to complete for that project

Step 4: Get me the preview link so I can view it in the editor

Step 5: Now update the project with the local file ./examples/sample-openapi.json
and merge it with the existing content, then publish it

Step 6: Finally, publish the project and show me the published URL

🔧 显式工具调用版本(用于测试)

如果您需要精确控制或正在进行调试:```
Step 1: List workspaces
Use theneo_list_workspaces

Step 2: Create a project with AI generation
Use theneo_create_project with:
- name: "USPTO API Documentation"
- link: "https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/examples/v3.0/uspto.json"
- publish: true
- isPublic: true
- descriptionGeneration: "FILL"

Step 3: Wait for AI to finish
Use theneo_wait_for_generation with the project ID from step 2

Step 4: Get the preview link
Use theneo_preview_link with the project ID

Step 5: Import an update (merge mode)
Use theneo_import_project_document with:
- projectId: (from step 2)
- file: "./examples/sample-openapi.json"
- importOption: "MERGE"
- publish: true

Step 6: Get final published URL
Use theneo_publish_project with the project ID


### 💡 现实生活中的对话示例```
You: "Hey, can you help me set up documentation for my API?"

AI: "Of course! Do you have an OpenAPI spec?"

You: "Yes, it's at https://api.mycompany.com/openapi.json"

AI: "Great! What would you like to name the project?"

You: "Call it 'MyCompany API v2' and make it public with AI descriptions"

AI: *[Creates project, waits for AI, shows preview link]*
"Done! Your documentation is live at [URL]. Would you like to make any changes?"

You: "Actually, I need to update the 'MyCompany API v2' project with a new spec"

AI: *[Automatically looks up project by name, imports new spec]*
"Updated! The changes have been merged and published."

🎯 使用名称代替ID(再也不用复制粘贴了!)

其中一个最强大的功能是能够引用 按名称查找项目和工作区:```

Old way (hard to remember)

"Create project in workspace ws_abc123 and publish project proj_xyz456"

New way (natural)

"Create a project in my 'Engineering' workspace and publish the 'Payment API' project"


人工智能将自动:

1. 解析工作区名称 → 工作区ID(如需)
1. 解析项目名称 → 项目ID(如需要)
1. 执行操作
1. 返回一条友好的信息

**这适用于:**

- ✅ 工作区引用:ID、密钥(slug)或名称
- ✅ 项目参考:ID或名称
- ✅ 项目的所有操作:创建、导入、发布、预览、删除、导出
- ✅ 版本管理:列出、创建、删除版本
- ✅ AI生成:等待完成,检查状态
- ✅ 外部集成:列出Postman集合,添加订阅者

**再也不用复制粘贴那些晦涩难懂的ID了!**

更多示例在 `examples/demo-prompts.md`。

## 安全最佳实践

### ✅ 做

- **使用操作系统密钥链** 本地机器上的API密钥
- **使用环境变量** 在持续集成/持续交付(CI/CD)和容器技术中
- **启用密码掩码** 在你的持续集成(CI)日志中
- **轮换API密钥** 定期并在演示后(进行)
- **使用配置文件** 隔离环境
- **评论 `.gitignore`** 排除秘密
- **使用 `.npmignore`** 防止泄露秘密

### ❌ 不要

- **永远不要承诺** API密钥到git
- **从不记录** 完整的配置对象
- **永远不要使用** URL或查询参数中的API密钥
- **永远不要分享** 公共频道中的API密钥
- **避免** 将密钥存储在项目RC文件中并提交到git

### CI/CD 集成

GitHub Actions 的工作流示例:```yaml
name: Update API Docs

on:
push:
paths:
- 'openapi.yaml'

jobs:
update-docs:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3

- name: Setup Node.js
uses: actions/setup-node@v3
with:
node-version: '18'

- name: Install Theneo MCP
run: npm install -g theneo-mcp

- name: Update Documentation
env:
THENEO_API_KEY: ${{ secrets.THENEO_API_KEY }}
run: |
# Your automation script here
# Call MCP tools via a script or AI assistant

持续集成(CI)的安全注意事项:

  • 商店 THENEO_API_KEY 作为GitHub密钥
  • 使用 secrets. 语法以避免暴露
  • 如果Theneo支持OIDC,请考虑使用短期有效令牌
  • 日志中的掩码秘密: echo "::add-mask::$THENEO_API_KEY"

发展

从源代码构建```bash

git clone https://github.com/atombreak/theneo-mcp.git
cd theneo-mcp
npm install
npm run build


### 开发模式```bash
npm run dev  # Start server with auto-reload

代码质量```bash

npm run lint # Run ESLint
npm run format # Format with Prettier
npm run type-check # TypeScript validation


### 项目结构```
theneo-mcp/
├── src/
│   ├── server.ts       # MCP server implementation
│   ├── cli.ts          # CLI commands
│   ├── config.ts       # Configuration schema
│   ├── loadConfig.ts   # Multi-source config loader
│   ├── credentials.ts  # Keychain management
│   └── utils/
│       └── logger.ts   # Structured logging with secret masking
├── examples/           # Sample files and demos
├── dist/              # Compiled output
└── package.json

故障排除

API密钥未找到

问题: 服务器退出,提示“API密钥未配置”

解决方案:

  1. 设置环境变量: export THENEO_API_KEY=your_key
  2. 保存到钥匙串: theneo-mcp creds save --apiKey your_key
  3. 检查个人资料: theneo-mcp server --profile default

钥匙串不可用

问题: “操作系统的钥匙串不可用”

解决方案: 请改用环境变量或配置文件:```bash
export THENEO_API_KEY=your_key
theneo-mcp server


### MCP服务器无法连接

**问题:** AI助手找不到工具

**解决方案:**

1. 配置更改后重启您的AI助手
1. 检查日志:查找MCP连接错误
1. 验证命令路径:使用绝对路径 `theneo-mcp`
1. 手动测试:运行 `theneo-mcp server` 查看启动日志

### 导入失败

**问题:** “无法导入文档”

**解决方案:**

1. 验证文件路径或URL是否可访问
1. 确保OpenAPI规范是有效的JSON/YAML格式
1. 检查项目ID是否正确
1. 审查API密钥权限

### AI生成超时

**问题:** “生成失败或超时”

**解决方案:**

1. 增加超时时间: `maxWaitTimeMs: 300000` (5分钟)
1. 检查Theneo仪表板以查看生成状态
1. 再试一次——大规格可能需要一些时间

## 发布到 npm

### 预发布检查清单

- \[ \] 更新版本中的 `package.json`
- \[ \] 运行 `npm run type-check`
- \[ \] 运行 `npm run lint`
- \[ \] 测试构建: `npm run build`
- \[ \] 验证 `.npmignore` 排除秘密
- \[ \] 测试安装: `npm pack` 并在本地安装
- \[ \] 更新 CHANGELOG.md 文件

### 发布```bash
npm run prepublishOnly  # Runs checks and build
npm publish

什么会被发表

✅ 包括:

  • 编译后的JavaScriptdist/)
  • 包元数据(package.json)
  • 文档(README.md, LICENSE)

❌(表示错误或否定) 被排除在外 (通过 .npmignore):

  • TypeScript 源代码(src/)
  • 测试文件和覆盖率(src/__tests__/, coverage/, *.test.ts)
  • 环境文件(.env, .env.*)
  • 包含潜在敏感信息的示例配置(.theneo-mcp.json, .theneo-mcp.yaml)
  • 开发配置(tsconfig.json, vitest.config.ts, eslint.config.js)
  • CI/CD 配置(.github/,GitHub Actions 工作流)
  • Docker 文件(Dockerfile, .dockerignore)
  • IDE 设置 (.vscode/, .idea/)

安全提示: 这个(或:那个) .npmignore 文件已配置为排除所有可能敏感的文件。发布前请务必检查:```bash

Preview what will be published

npm pack --dry-run

Check for secrets in package

tar -tzf theneo-mcp-*.tgz | grep -E '.(env|key|pem|crt)'


## 测试

这个项目具有全面的测试覆盖率,包括单元测试和集成测试。```bash
# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

# Run tests with coverage
npm run test:coverage

# Open test UI
npm run test:ui

遥测

Theneo MCP 包括 可选的,以隐私为先的遥测技术 以帮助改进该工具。遥测是指:

  • ✅ 选择加入(或:自愿注册) - 默认禁用
  • ✅ 匿名 - 未收集任何个人数据
  • ✅ 本地 - 存储在您机器上的数据
  • ✅ 透明的 - 随时查看 `theneo-mcp telemetry status````bash

Enable telemetry

theneo-mcp telemetry enable

View what's collected

theneo-mcp telemetry status

Disable anytime

theneo-mcp telemetry disable
```

持续集成/持续交付(CI/CD)

该项目包含了全面的GitHub Actions工作流:

  • CI(企业识别系统/品牌标识)每次推送/拉取请求时,都在 Node 18、20、22 上运行测试
  • 发布自动在npm上发布并在版本标签时更新Homebrew
  • 质量每周进行安全审计和依赖项检查

做出贡献

欢迎投稿!请:

  1. 为仓库创建分支(或“克隆仓库”)
  2. 创建一个特性分支
  3. 为新功能编写测试
  4. 确保所有检查均通过: npm test
  5. 提交一个拉取请求

许可证

MIT 许可证 - 详见 许可证 文件详情请见附件

链接

支持

  • 文档这个README文件以及 examples/demo-prompts.md
  • 问题: GitHub Issues(GitHub问题)

用心打造,迎接AI赋能的文档新时代

将Theneo定位为开发者文档的自动化核心工具

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Theneo MCP Server 怎么安装?

在客户端按下面的安装命令接入:docker run -it --rm \。装完在客户端配置里引用同一个包或端点。

Theneo MCP Server 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Theneo MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Theneo MCP Server 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

Theneo MCP Server 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Theneo MCP Server 能提供哪些能力?

资料显示约 15 个工具;能力标签包括 API文档、开发工具、TypeScript、Claude、CI/CD。具体工具清单以官方文档为准。

Theneo MCP Server 需要什么运行环境?

运行时为 Docker;属于本地进程,需要在本机装好运行环境。

Theneo MCP Server 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。