Auth Example

MCPAI代理

提供方 authaction

AI代理 未标注 OAuth 授权 社区 / 第三方

一个基于HTTP的模型上下文协议(MCP)服务器实现,支持OAuth2/JWT认证,提供RESTful API和服务器发送事件支持,适用于模型上下文协议通信。

一句话选型结论

按资料字段整理

Auth Example 属于AI代理类 MCP 服务器,传输方式未标注,OAuth 授权,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权OAuth 授权 部署方式未标注
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 3 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

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

能力标签

适用场景

协议服务器JavaScript本地部署HTTP服务OAuth2认证JWT认证RESTfulAPI服务器发送事件

安装与配置

未标注 OAuth 授权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

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

值得选的地方

  • 资料标注 3 个工具,职责相对集中,接入后不容易误操作。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Auth Example当前 3 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方authaction上游标注的维护方 authaction
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

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

MCP HTTP服务器

基于HTTP的模型上下文协议(MCP)服务器实现,支持OAuth2/JWT身份验证。

特性

  • MCP协议支持:实现模型上下文协议(MCP)规范(v2025-06-18)
  • OAuth2/JWT身份验证:使用AuthAction进行安全身份验证
  • HTTP传输:用于MCP通信的RESTful API端点
  • 流式HTTP传输:MCP检查器的服务器发送事件支持
  • 工具系统:具有内置工具的可扩展工具框架
  • 根系:MCP Inspector的文件系统根支持
  • 健康监测:内置健康检查和监控端点

内置工具

  1. 回声:回显输入文本
  2. 时间:获取当前服务器时间
  3. 计算:执行基本的数学计算

快速开始

先决条件

  • Node.js 16.0.0或更高版本
  • npm或纱线

安装

  1. 克隆存储库:```bash
    git clone
    cd mcp-server

2. 安装依赖项:```bash
npm install
  1. 创建一个 .env 使用您的配置文件:```env

Server Configuration

PORT=3000
APP_DOMAIN=http://localhost

AuthAction Configuration

AUTHACTION_DOMAIN=tenant-name.tenant-region.authaction.com
AUTHACTION_AUDIENCE=your-authaction-api-identifier


4. 启动服务器:```bash
npm start

对于自动重启的开发:```bash
npm run dev


## API终点

### 公共端点

- `GET /` -服务器信息和可用端点
- `GET /health` -健康检查端点
- `GET /.well-known/oauth-authorization-server` -OAuth2授权服务器元数据
- `GET /.well-known/oauth-protected-resource` -OAuth2受保护的资源元数据

### 受保护的端点

- `POST /mcp` -MCP协议端点(需要JWT身份验证)
- `POST /mcp/stream` -StreamableHTTP MCP端点(对于MCP检查器,需要JWT身份验证)

## MCP协议

服务器实现以下MCP方法:

### `initialize`

初始化MCP连接并协商协议版本。

**请求:**```json
{
"jsonrpc": "2.0",
"id": "1",
"method": "initialize",
"params": {}
}

答复:```json
{
"jsonrpc": "2.0",
"id": 0,
"result": {
"protocolVersion": "2025-06-18",
"capabilities": {
"tools": {},
"sampling": {},
"roots": {
"listChanged": true
}
},
"serverInfo": {
"name": "mcp-server",
"version": "1.0.0"
}
}
}


### `tools/list`

列出可用工具。

**请求:**```json
{
"jsonrpc": "2.0",
"id": "2",
"method": "tools/list",
"params": {}
}

答复:```json
{
"jsonrpc": "2.0",
"id": "2",
"result": {
"tools": [
{
"name": "echo",
"description": "Echo back the input text",
"inputSchema": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Text to echo back"
}
},
"required": ["text"]
}
}
]
}
}


### `roots/list`

列出可用的文件系统根目录。

**请求:**```json
{
"jsonrpc": "2.0",
"id": "3",
"method": "roots/list",
"params": {}
}

答复:```json
{
"jsonrpc": "2.0",
"id": "3",
"result": {
"roots": [
{
"name": "default",
"uri": "file:///",
"description": "Default file system root"
}
]
}
}


### `tools/call`

执行一个工具。

**请求:**```json
{
"jsonrpc": "2.0",
"id": "3",
"method": "tools/call",
"params": {
"name": "echo",
"arguments": {
"text": "Hello, World!"
}
}
}

答复:```json
{
"jsonrpc": "2.0",
"id": "3",
"result": {
"content": [
{
"type": "text",
"text": "Echo: Hello, World!"
}
]
}
}


## 认证

MCP的主要终点(`/mcp`)需要JWT身份验证。在Authorization标头中包含JWT令牌:```
Authorization: Bearer

两个MCP端点都需要JWT身份验证以确保安全性和一致性。

JWT配置

服务器使用以下配置验证JWT:

  • 发行人: https://{AUTHACTION_DOMAIN}/
  • 观众: {AUTHACTION_AUDIENCE}
  • 算法:RS256
  • JWKS端点: https://{AUTHACTION_DOMAIN}/.well-known/jwks.json

项目结构```

mcp-server/
├── src/
│ ├── server.js # Main Express server setup
│ ├── mcp-handler.js # MCP protocol handler
│ ├── streamable-http-handler.js # StreamableHTTP handler
│ └── tools.js # Tool definitions and handlers
├── index.js # Entry point
├── test-client.js # Test client
├── package.json # Dependencies and scripts
└── README.md # Documentation


## 添加自定义工具

要添加自定义工具,请修改 `src/tools.js` 文件:

1. 将工具定义添加到 `tools` 数组:```javascript
{
name: "my-tool",
description: "Description of my tool",
inputSchema: {
type: "object",
properties: {
// Define your tool's parameters
},
required: ["required-param"]
}
}
  1. 将工具处理程序添加到 toolHandlers 对象:```javascript
    my-tool: async (args) => {
    // Implement your tool logic
    return {
    content: [
    {
    type: "text",
    text: "Tool result"
    }
    ]
    };
    }

## 测试

运行测试客户端以验证服务器功能:```bash
npm test

这将测试所有端点并验证身份验证要求。

环境变量

变量 描述 默认值
PORT 服务器端口 3000
APP_DOMAIN 服务器域 http://localhost
AUTHACTION_DOMAIN OAuth2提供程序域 必填
AUTHACTION_AUDIENCE OAuth2受众 必填

错误处理

服务器使用标准错误代码实现了正确的JSON-RPC 2.0错误处理:

  • -32700:分析错误
  • -32600:无效请求
  • -32601:未找到方法
  • -32602:无效参数
  • -32603:内部错误

安全考虑

  1. JWT验证:所有MCP请求都需要有效的JWT令牌
  2. 速率限制:JWKS请求受到速率限制,以防止DoS攻击
  3. 输入验证:所有工具输入都根据模式进行验证
  4. 错误处理:敏感信息不会在错误消息中暴露

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
Auth Example 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Auth Example 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Auth Example 收费吗?

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

Auth Example 需要 API Key 吗?

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

Auth Example 能提供哪些能力?

资料显示约 3 个工具;能力标签包括 API集成、JavaScript、HTTP服务。具体工具清单以官方文档为准。

热门专题

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

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