Notes MCP E3648597

MCPAI代理

提供方 bhaveshdaswani93

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

一个基于Express.js和Passport.js构建的MCP服务器,通过Auth0进行用户认证并提供与Notes API交互的工具。

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

适用场景

认证服务TypeScript本地部署MCP协议Express.jsAuth0Passport.js

安装与配置

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

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

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

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

多步任务编排

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

自动化重复流程

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

选择建议

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

值得选的地方

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

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Notes MCP E3648597当前 2 未标注 未标注 无 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代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方bhaveshdaswani93上游标注的维护方 bhaveshdaswani93
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

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

Notes MCP Server with Auth0 & Express

A Model Context Protocol (MCP) server built with Express.js and Passport.js that authenticates users via Auth0 and provides tools to interact with a Notes API.

Features

  • ✅ whoami: Get current user's Auth0 profile and claims
  • ✅ list-notes: Fetch notes from Notes API using authenticated user's token
  • ✅ Auth0 OAuth 2.0 authentication flow
  • ✅ Session-based authentication with Passport.js
  • ✅ SSE transport for MCP protocol
  • ✅ Platform agnostic (runs anywhere Node.js works)

Architecture```

MCP Client → Express Server → Auth0 → Notes API
↓
Passport.js
↓
Session Storage


## Prerequisites

- Node.js 18+ and npm
- Auth0 account with application configured
- Notes API running (default: http://localhost:3000)

## Quick Setup

### 1. Install Dependencies```bash
npm install

2. Configure Auth0

  1. Create Auth0 Application (Regular Web Application)
  2. Configure Application Settings:
    - Allowed Callback URLs: http://localhost:3001/callback
    - Allowed Logout URLs: http://localhost:3001
    - Allowed Web Origins: http://localhost:3001

  3. Create Auth0 API for your Notes API:
    - Identifier: https://notes-api (or your custom identifier)
    - Signing Algorithm: RS256
    - Permissions: Add read:notes scope

3. Configure Environment

Copy .dev.vars.example to .env:```bash
cp .dev.vars.example .env


Edit `.env` with your Auth0 credentials:```env
AUTH0_DOMAIN=your-tenant.auth0.com
AUTH0_CLIENT_ID=your_client_id_here
AUTH0_CLIENT_SECRET=your_client_secret_here
AUTH0_CALLBACK_URL=http://localhost:3001/callback
AUTH0_AUDIENCE=https://notes-api

SESSION_SECRET=generate-a-strong-random-secret

API_BASE_URL=http://localhost:3000
PORT=3001
NODE_ENV=development

Generate SESSION_SECRET:```bash
node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"


### 4. Start the Server

**Development** (with auto-reload):```bash
npm run dev

Production:```bash
npm run build
npm start


Server will start at: `http://localhost:3001`

## Usage

### 1. Authentication Flow

1. Visit `http://localhost:3001`
2. Click "Login" to authenticate with Auth0
3. After successful login, you'll be redirected back

### 2. MCP Client Connection

Configure your MCP client to connect to:```
http://localhost:3001/mcp/sse

The server will ensure authentication before allowing MCP connections.

3. Available Tools

whoami

Returns current user's profile and Auth0 claims:```json
{
"profile": {
"id": "auth0|...",
"displayName": "John Doe",
"emails": [{"value": "john@example.com"}]
},
"claims": {
"sub": "auth0|...",
"email": "john@example.com",
"aud": "...",
"iat": 1234567890
}
}


#### `list-notes`
Fetches notes from the Notes API using the user's access token:```json
[
  {
    "id": 1,
    "title": "My Note",
    "content": "Note content",
    "userId": "auth0|..."
  }
]

API Endpoints

Endpoint Method Description
/ GET Home page (shows login status)
/login GET Initiates Auth0 login
/callback GET Auth0 callback URL
/logout GET Logs out user and redirects to Auth0 logout
/mcp/sse GET MCP SSE transport (requires authentication)
/health GET Health check endpoint

Notes API Requirements

Your Notes API must:
1. Accept JWT tokens from Auth0 in Authorization: Bearer header
2. Validate tokens against your Auth0 tenant
3. Have an endpoint at /api/notes that returns user-specific notes

Example NestJS Auth Middleware```typescript

@Injectable()
export class Auth0JwtMiddleware implements NestMiddleware {
async use(req: Request, res: Response, next: NextFunction) {
const token = req.headers.authorization?.replace('Bearer ', '');

// Validate token with Auth0
const jwks = jose.createRemoteJWKSet(
  new URL(`https://${process.env.AUTH0_DOMAIN}/.well-known/jwks.json`)
);

const { payload } = await jose.jwtVerify(token, jwks, {
  audience: process.env.AUTH0_AUDIENCE,
  issuer: `https://${process.env.AUTH0_DOMAIN}/`,
});

req.user = payload;
next();

}
}


## Deployment

### Local Development```bash
npm run dev

Production Deployment

Option 1: Node.js Server (Railway, Heroku, AWS, etc.)```bash
npm run build
npm start


**Option 2: Docker**```dockerfile
FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY dist ./dist
CMD ["node", "dist/index.js"]

Option 3: PM2```bash
npm install -g pm2
npm run build
pm2 start dist/index.js --name mcp-notes


## Troubleshooting

### "Missing required environment variables"
- Ensure all variables in `.env` are set
- Check that `.env` file exists in project root

### "Invalid Compact JWS" from Notes API
- Verify `AUTH0_AUDIENCE` matches your Auth0 API identifier
- Ensure Notes API is validating tokens correctly
- Check that access token is being sent in Authorization header

### MCP Connection Fails
- Ensure you're authenticated (visit `/login` first)
- Check that MCP client URL is `http://localhost:3001/mcp/sse`
- Verify server is running and accessible

### Session Issues
- Generate a strong `SESSION_SECRET`
- In production, set `NODE_ENV=production` for secure cookies
- Use Redis or database for session storage in production (currently in-memory)

## Project Structure```
notes-mcp/
├── src/
│   ├── index.ts       # Express app and MCP server setup
│   ├── auth.ts        # Passport Auth0 configuration
│   └── types.ts       # TypeScript type definitions
├── package.json       # Dependencies and scripts
├── tsconfig.json      # TypeScript configuration
├── .env               # Environment variables (create from .dev.vars.example)
└── README.md          # This file

Comparison with Cloudflare Version

Feature Cloudflare Workers Express.js
Deployment Cloudflare only Any platform
Dependencies Cloudflare-specific Standard Node.js
Session Storage Durable Objects + KV In-memory or Redis
Setup Complexity High Medium
Cost Cloudflare pricing Server hosting

License

MIT

常见问题

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

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

Notes MCP E3648597 怎么在客户端里配置?

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

Notes MCP E3648597 收费吗?

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

Notes MCP E3648597 需要 API Key 吗?

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

Notes MCP E3648597 能提供哪些能力?

资料显示约 2 个工具;能力标签包括 认证服务、TypeScript、AI代理。具体工具清单以官方文档为准。

热门专题

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

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