Naptha AI MCP

MCP开发工具

提供方 NapthaAI · 包名 mcp-remote

开发工具 stdio · 本地进程 无需鉴权 社区 / 第三方 ClaudeCursorClaude Desktop
查看接入方式

Remote MCP server (SEE + Streamable HTTP) implementing the MCP spec's authorization extension. Use directly from your agents, or from Cursor / Claude with mcp-remote

一句话选型结论

按资料字段整理

Naptha AI MCP 属于开发工具类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude、Cursor、Claude Desktop,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

支持客户端

适用场景

developer-toolsMCP协议TypeScript本地部署OAuth授权HTTP传输SSE传输服务器实现

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
npx mcp-remote --transport http-first https://some-domain.server.com/mcp

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

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

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

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

本地命令与脚本

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

接口联调与测试

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

选择建议

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

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude、Cursor、Claude Desktop,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Naptha AI MCP当前 未标注 stdio · 本地进程 支持远程部署 有 2026-05-18
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

服务器档案

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

详细介绍

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

🌊 HTTP+SSE MCP服务器,带OAuth

引言

此仓库提供了一个参考实现,用于创建支持流式HTTP和SSE传输的远程MCP服务器,该服务器基于MCP规范通过OAuth授权。

请注意,此仓库中的MCP服务器在逻辑上与处理报告SSE+HTTP传输的应用程序以及OAuth是分开的。

因此,您可以轻松地分叉此仓库,并插入您自己的MCP服务器和OAuth凭据,以获得具有您自己功能的工作SSE/HTTP+OAuth MCP服务器。

> 但是,为什么呢?

好问题!MCP规范于2025年3月25日添加了基于OAuth的授权规范。目前,截至2025年5月1日:

  • Typescript SDK包含许多构建块,用于实现具有流式HTTP的OAuth授权MCP服务器, 但是没有文档或教程 如何构建这样一个服务器
  • Python SDK既不包含流式HTTP传输的实现,也不包含typescript SDK中存在的OAuth构建块的实现
  • MCP主机应用程序(如Cursor和Claude桌面)广泛不支持流式HTTP传输,尽管它可以使用JS/TS SDK直接集成到用JavaScript编写的代理中 StreamableHttpClientTransport 类

在 石脑油AI,我们真的很想在流式HTTP传输上构建一个OAuth授权的MCP服务器,但找不到任何参考实现,所以我们决定自己构建一个!

依赖项

包子,一个快速的一体化JavaScript运行时,是此存储库的推荐运行时和包管理器。已完成有限兼容性测试 npm + tsc.

概述

此存储库提供以下功能:

  1. MCP服务器,您可以轻松地用自己的服务器替换
  2. 一个管理express.js的应用程序 两者 SSE和流式HTTP传输 和 OAuth授权。

这个快速应用程序是您将凭据和MCP服务器插入其中的应用程序。

请注意,虽然此express应用程序实现了所需的OAuth端点,包括 /authorize 以及授权服务器元数据端点(RFC8414), 它没有实现OAuth授权服务器!

此示例将OAuth代理到支持动态客户端注册的上游OAuth服务器(RFC7591).要使用此示例,您需要携带自己的授权服务器。我们建议使用 身份验证0;见 “设置OAuth”部分 在......下面

配置服务器

OAuth和动态客户端注册说明

要使用此示例,您需要一个OAuth授权服务器。 不要自己动手! 为了创建我们的演示,我们使用了 身份验证0 --这是一个很好的选择,尽管还有许多其他选择。

MCP规范要求支持一个不常见的OAuth功能,特别是 RFC7591,动态客户端注册。这 MCP规范 指定MCP客户端和服务器应支持动态客户端注册协议,以便MCP客户端(无论您的客户端传输是否有效)可以在不进行用户注册的情况下获得客户端ID。这允许新客户端(代理、应用程序等)自动向新服务器注册。有关此的更多详细信息,请参阅 在MCP规范的授权部分,但这意味着不幸的是,你不能简单地直接代理到谷歌或GitHub等不支持动态客户端注册的提供商(他们要求你在他们的UI中注册客户端)。

这给你留下了两个选择:

  1. 选择一个像Auth0这样的上游OAuth提供程序,它允许您使用像谷歌和GitHub这样的OIDC IDPs进行身份验证 做 支持动态客户端注册,或
  2. 在应用程序中自己实现动态客户端注册(即,express应用程序不仅成为一个简单的OAuth代理,而且成为一个完整或部分完整的OAuth服务器)。Cloudflare为其Workers OAuth MCP服务器实现了类似的功能,我们稍后可能会扩展此项目。你可以找到 这里.

为了简单起见,我们选择了使用Auth0的前一个选项。

> [!注意]\
> 由于此实现代理了上游OAuth服务器,因此将访问令牌从OAuth服务器转发到客户端的默认方法将用户的上游访问令牌暴露给下游客户端和MCP主机。这不适合许多用例,因此这种方法重新实现了一些 @modelcontextprotocol/typescript-sdk 类来解决这个问题。

请注意,当我们代理上游授权服务器时,我们 不 将最终用户的身份验证令牌返回给MCP客户端/主机-相反,我们正在发行自己的令牌,并允许客户端/主机使用该令牌向我们的服务器进行授权。这可以防止恶意客户端或主机滥用令牌,或者在令牌泄露时被滥用。

使用Auth0设置OAuth

要开始使用Auth0,请执行以下操作:

  1. 在以下位置创建Auth0帐户 Auth0.com.
  2. 至少创建一个与IDP(如Google或GitHub)的连接。你可以 在这里学习如何做到这一点.
  3. 促进与 域级连接。由于每个MCP客户端都注册了新的OAuth客户端,因此您无法在每个应用程序/客户端的基础上配置IDP连接。这意味着您的连接需要可用于域中的所有应用程序。你可以 在这里学习如何做到这一点.
  4. 启用动态客户端注册(auth0也称此为“动态应用程序注册”)。你可以 在这里学习如何做到这一点.

所有这些设置完毕后,您将需要以下信息:

  • 您的Auth0客户端ID
  • 您的Auth0客户端密码
  • 您的Auth0租户域

请确保将此信息填写到您的 .env.复制 .env.template 然后使用您的配置和机密更新这些值。

运行服务器

此存储库包括两个独立的服务器:

  • 一 无状态 流式HTTP服务器的实现 src/app.stateless.ts。这只支持可流式传输的HTTP,并且(理论上)适用于无服务器部署
  • 一 有状态的 SSE和流式HTTP在 src/app.stateful.ts。此应用程序提供这两种传输方式,但即使在使用时也会保持内存状态 redis 存储策略(连接必须持久化在内存中),因此它不适合无服务器部署或微不足道的水平扩展。

你可以用它们中的任何一个来运行 bun:```shell
bun run src/app.stateless.ts

or,

bun run src/app.stateful.ts


## 把它们放在一起

要测试我们的MCP服务器是否支持流式HTTP和OAuth,您有几个选择。

如上所述,Python MCP SDK不支持这些功能,因此目前您可以将我们的远程服务器插入像Cursor或Claude Desktop这样的MCP主机,也可以直接插入TypeScript/JavaScript应用程序,但不能插入Python应用程序。

### 将服务器插入MCP主机(Cursor/Claude)

由于大多数MCP主机不支持流式HTTP(在许多方面优于SSE) _或_ OAuth,我们建议使用 `mcp-remote` npm包将处理OAuth授权,并将远程传输桥接到主机的STDIO传输中。

命令看起来像这样:```shell
bunx mcp-remote --transport http-first https://some-domain.server.com/mcp
# or,
npx mcp-remote --transport http-first https://some-domain.server.com/mcp

你有几个选择 --transport 选项:

  • http-first (默认):首先尝试HTTP传输,如果HTTP失败并出现404错误,则回退到SSE
  • sse-first:首先尝试SSE传输,如果SSE失败并出现405错误,则回退到HTTP
  • http-only:仅使用HTTP传输,如果服务器不支持则失败
  • sse-only:仅使用SSE传输,如果服务器不支持,则失败

> [!注意]
> 如果你启动 无状态 服务器的版本 src/app.stateless.ts,SSE传输不可用,因此您应该使用 --transport http-only如果您使用此入口点,则预计SSE传输将无法工作。

将服务器插入代理

您可以使用以下命令将Streamable HTTP服务器插入JS/TS中的代理 StreamableHTTPClientTransport。但是,这不适用于受OAuth保护的服务器。相反,你应该使用 Authorization 客户端的标头,服务器端具有有效的访问令牌。

您可以使用客户端凭据、API密钥或其他东西来实现这一点。此存储库不支持该模式,但使用 Vercel AI SDK:```typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMcpClient, generateText } from 'ai';
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const mcpClient = await createMcpClient({
transport: new StreamableHTTPClientTransport(
new URL("http://localhost:5050/mcp"), {
requestInit: {
headers: {
Authorization: "Bearer YOUR TOKEN HERE",
},
},
// TODO add OAuth client provider if you want
authProvider: undefined,
}),
});

const tools = await mcpClient.tools();
await generateText({
model: openai("gpt-4o"),
prompt: "Hello, world!",
tools: {
...(await mcpClient.tools())
}
});

```

常见问题

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

在客户端按下面的安装命令接入:npx mcp-remote --transport http-first https://some-domain.server.com/mcp。对应的包名是 mcp-remote。装完在客户端配置里引用同一个包或端点。

Naptha AI MCP 怎么在 Claude、Cursor、Claude Desktop 里配置?

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

Naptha AI MCP 收费吗?

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

Naptha AI MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Naptha AI MCP 支持哪些客户端?

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

Naptha AI MCP 能提供哪些能力?

资料显示能力标签包括 服务器实现、HTTP传输、TypeScript、Claude。具体工具清单以官方文档为准。

Naptha AI MCP 需要什么运行环境?

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

Naptha AI MCP 是本地还是远程?

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

热门专题

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

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