MCP Server Blog

MCP搜索检索

提供方 portal-labs-infrastructure

搜索检索 未标注 OAuth 授权 社区 / 第三方

Example of a MCP implementation using TypeScript and OAuth.

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

适用场景

research-and-dataaimcpagentsmcp-servermcp-clientmcp-hostMCP服务器

安装与配置

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

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
联网搜索取证

让模型查最新资料并给出出处。

资料聚合

把一个主题的网页、文档集中抓回来整理。

情报与竞品检索

按关键词持续检索行业动态和竞品信息。

选择建议

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

值得选的地方

  • 基础信息齐全,可以先按官方文档接入试跑。

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Server Blog当前 未标注 未标注 未标注 无 2026-05-18
Brave Search 433812ff 2 未标注 未标注 无 2026-05-17
Sequentialthinking 1 SSE · 服务端推送 远程部署 有 2026-05-18
Baidu Netdisk 未标注 未标注 未标注 无 2026-05-17
ragflow 未标注 stdio · 本地进程 本地部署 有 2026-04-11
mindsdb (430e18) 未标注 未标注 未标注 有 2026-05-17

服务器档案

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

详细介绍

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

MCP服务器演示:OAuth、TypeScript和Firestore模式

该存储库提供了一个简化的、说明性的模型上下文协议(MCP)服务器实现。它展示了我们随附文章中详细介绍的架构模式、安全考虑因素(OAuth 2.0)和开发实践(TypeScript、Firestore、Zod):

➡️ 阅读完整故事:“使用OAuth、TypeScript和我们的战斗伤痕构建生产就绪的MCP服务器"

此演示侧重于 MCP资源服务器 组件,并假设您有一个单独的OAuth 2.0授权服务器。

更新:MCP SDK 1.12.0版本引入了对授权服务器元数据(/.wearned/oauth授权服务器)的支持,并消除了通过MCP资源服务器代理oauth调用的需要。

目的

该存储库旨在作为学习资源,用于:

  • 使用TypeScript MCP SDK演示MCP服务器的实际实现。
  • 说明如何集成OAuth 2.0以保护工具调用。
  • 展示用于管理工作空间上下文和多租户的模式。
  • 提供使用Zod进行模式定义和验证的示例。
  • 提供结构化工具的见解,使用高阶组件(HOC)进行通用逻辑,并与Firestore交互。

这不是一个适用于所有用例的生产就绪即插即用服务器。 它省略了特定的业务逻辑,并假设预先存在OAuth授权服务器。

展示的主要特征和模式

  • MCP TypeScript SDK集成: 核心服务器设置和工具注册。
  • OAuth 2.0令牌验证: 安全地处理Bearer令牌(通过SDK中间件)。
  • 工作区上下文管理:
  • 明确的 workspace_id 在工具论证中。
  • withWorkspaceAccess 用于身份验证和工作空间授权的高阶组件(HOC)。
  • Firestore集成:
  • 获取用户数据、OAuth令牌信息(概念性)和特定于工具的数据。
  • 使用Firestore模拟器进行本地开发和测试。
  • Zod用于模式和验证: 为工具定义输入模式,并利用Zod进行运行时验证。
  • 类型安全开发: 利用TypeScript编写健壮的代码。
  • 实用功能: 的示例 fetchResourceList 用于获取DRY数据。
  • 标准化错误处理: 使用 throw new Error() 以实现清晰的错误传播。
  • 工具结构示例: 展示模式的基本工具定义。
  • 环境变量配置: 用于数据库和OAuth设置。

结构概述

这个演示代表了 MCP资源服务器。它希望OAuth 2.0承载令牌由单独的 OAuth授权服务器.`` [Client / LLM with MCP Client SDK] | | (HTTPS Request with Bearer Token) v [This MCP Resource Server (Node.js / TypeScript)] | 1. MCP SDK Middleware (parses request, extracts token) | 2.withWorkspaceAccess` HOC
| a. Using the userId associated with the token
| b. Validates the user can access the workspace_id in the request
| 3. Tool Handler Execution (interacts with Firestore based on validated context)
|
v
[Google Firestore (Database)]


OAuth授权服务器(您将提供或现有的)负责:

- 对用户进行身份验证。
- 发放OAuth令牌(访问令牌、刷新令牌)。
- 管理OAuth客户端(动态发现)。

然后,此资源服务器验证从客户端接收到的令牌。

## 先决条件

- Node.js(建议使用v18.x或更高版本)
- npm或纱线
- 访问启用了Firestore的Google Cloud项目,或为Firestore模拟器配置了Google Cloud SDK。
- 现有的OAuth 2.0授权服务器。

## 入门指南

1. **克隆存储库:**```bash
git clone https://github.com/portal-labs-infrastructure/mcp-server-blog
cd mcp-server-blog
  1. 安装依赖项:```bash
    npm install

or

yarn install


1. **设置环境变量:**
复制 `.env.example` 将文件转换为名为的新文件 `.env`:```bash
cp .env.example .env

现在,编辑 .env 并填写所需的配置值:```dotenv

Firestore Configuration

If using Firestore Emulator, these might not all be strictly needed,

but ensure your gcloud CLI is configured or provide necessary emulator host.

PROJECT_ID="your-gcp-project-id"

FIRESTORE_EMULATOR_HOST="localhost:8081" # Uncomment if using emulator and not relying on gcloud config

OAuth 2.0 Configuration (for this Resource Server to validate tokens)

This depends on your OAuth Authorization Server's setup.

OAUTH_ISSUER_URL="https_your_auth_server_com"

MCP Server Configuration

BASE_URL="http://localhost:8080" # URL this server is accessible at


**重要提示:** OAuth配置至关重要。此服务器需要知道如何验证授权服务器颁发的令牌。请查阅您的认证服务器文档。

1. **(可选)种子仓库数据:**
如果你有种子脚本,或者想手动添加一些示例用户、OAuth令牌(与你的Auth服务器会发出的令牌匹配)和工作区数据到你的Firestore实例/模拟器中,现在就这样做。这将使测试工具更有意义。

## 运行服务器

- **开发模式(带Nodemon自动重启):**```bash
npm run dev
  • 生产模式:
    bash npm run build npm start
    服务器通常会启动 http://localhost:8080 (或中指定的端口 .env).

使用Firestore模拟器运行

  1. 确保已安装并配置Google Cloud SDK。
  2. 在单独的终端中启动Firestore模拟器:```bash
    gcloud emulators firestore start --host-port=localhost:8081
(必要时调整端口并更新 `FIRESTORE_EMULATOR_HOST` 在……里面 `.env` 或确保您的应用程序通过以下方式自动检测到它 `gcloud` 环境变量)。
1. 如上所述运行MCP服务器。它应该连接到模拟器。

## 代码中展示的关键模式和概念

在 `src` 目录:

- **`src/index.ts`:** 主MCP服务器设置。
- **`src/controllers/mcpController.ts`:** 工具注册和MCP控制器处理传入请求。
- **`src/services/`:** 用于处理Firestore交互的服务层。
- **`src/tools/`:** 工具定义示例。
- 每个工具都有一个 `inputSchema` (Zod)和a `handler`.
- 处理器可能会被包裹 `withWorkspaceAccess`.
- **`src/utils/withWorkspaceAccess.ts`:** 工作空间检查的高阶组件。
- **`src/utils/fetchResourceList.ts`:** 可重用数据获取实用程序的示例。
- **`src/utils/types.ts`:** 共享的TypeScript类型和Zod模式(例如 `EntityType`, `ResourceType`).

## 目录结构```
.
├── src/
│   ├── tools/                # Tool definitions
│   │   ├── getAgentTool.ts
│   │   └── ...
│   ├── utils/                # Shared utilities, HOCs, types
│   │   ├── withWorkspaceAccess.ts
│   │   ├── types.ts
│   │   └── ...
│   ├── services/             # Interaction logic
│   │   ├── firestoreService.ts    # Firestore interaction logic
│   │   └── ...
│   ├── config/               # Configuration loading
│   └── index.ts              # Main server setup
├── .env.example              # Example environment variables
├── .env                      # Your local environment variables (ignored by git)
├── package.json
├── tsconfig.json
└── ...

这个演示是什么(不是什么)

  • 是: 演示用于构建安全的多租户MCP资源服务器的服务器端模式。
  • 是: 一种在MCP上下文中应用TypeScript、Zod、Firestore和OAuth概念的方法。
  • 不是: 一个完整的、生产就绪的OAuth授权服务器(您需要提供)。
  • 不是: 直接使用的库或SDK(这是一个示例应用程序)。
  • 不是: 充满了复杂的业务逻辑(工具是说明性的)。

贡献

这主要是一个演示存储库。但是,如果您发现错误或对提高演示模式的清晰度有建议,请随时打开问题或提交拉取请求。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

致谢

这个演示深受文章中讨论的经验和模式的启发:“使用OAuth、TypeScript和我们的战斗伤痕构建生产就绪的MCP服务器".

常见问题

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

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

MCP Server Blog 怎么在客户端里配置?

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

MCP Server Blog 收费吗?

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

MCP Server Blog 需要 API Key 吗?

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

MCP Server Blog 能提供哪些能力?

资料显示能力标签包括 多租户、AI代理、TypeScript。具体工具清单以官方文档为准。

热门专题

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

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