SSMCP (Antonsokolskyy)

MCP搜索检索

提供方 antonsokolskyy

搜索检索 stdio · 本地进程 OAuth 授权 社区 / 第三方 Claude
查看接入方式

SSMCP是一款自托管的MCP服务器,为AI模型提供网络搜索、内容提取和YouTube字幕获取功能。

一句话选型结论

按资料字段整理

SSMCP (Antonsokolskyy) 属于搜索检索类 MCP 服务器,stdio · 本地进程,OAuth 授权,可直接接入 Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

支持客户端

适用场景

网络搜索Python本地部署内容提取AI辅助自托管YouTube字幕

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
uv run python -m ssmcp.server

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

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

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

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

资料聚合

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

情报与竞品检索

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

选择建议

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

值得选的地方

  • 资料标注 3 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

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

服务器档案

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

详细介绍

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

SSMCP-超简单MCP服务器

模型上下文协议(MCP)服务器,提供具有内容提取的网络搜索。

为什么要使用SSMCP?

许多人工智能模型,特别是本地模型或某些基于云的模型,没有内置的网页浏览功能。SSMCP通过提供一个简单的自托管解决方案来弥合这一差距,该解决方案使您的AI助手能够:

  • 搜索和阅读网络:让你的AI搜索当前信息、阅读文章、文档或任何网络内容
  • 提取清洁内容:自动将杂乱的网页转换为AI模型可以轻松理解的干净Markdown格式
  • 访问YouTube成绩单:从带有时间戳的视频中提取字幕进行分析或总结
  • AI驱动的总结:可选的LLM摘要仅根据您的搜索查询从网页中提取相关信息
  • 注重隐私:自托管解决方案-您的搜索和浏览停留在您的基础设施上
  • 适用于任何型号:与支持MCP的本地模型(如Qwen、Llama)和云API(DeepSeek、Claude、GPT)兼容

示例用例:

  • 研究某一主题的最新消息或发展
  • 阅读并总结技术文档
  • 分析当前市场趋势或产品评论
  • 从YouTube教程或演示文稿中提取信息
  • 获取模型训练数据中没有的最新答案
  • 获取简洁、与查询相关的网络内容摘要(启用LLM摘要)

特性

  • 网络搜索:搜索网络并获取Markdown中提取内容的结果
  • Web提取:从任何URL中提取内容作为干净的Markdown
  • YouTube字幕:从YouTube视频中提取字幕和时间戳
  • LLM总结 (可选):使用LLM按与查询的相关性对搜索结果进行汇总和筛选
  • 由...驱动: 瑟克斯NG 为了搜索, Crawl4AI 对于内容提取, yt-dlp 用于字幕
  • 简单API:易于使用的界面设计用于兼容小型本地模型(如Qwen3 30b)和缺乏web功能的云模型(如DeepSeek 3.2)
  • 容器支持:使用Docker Compose进行完全容器化部署

快速开始

先决条件

  • 码头工人
  • Docker Compose

1.克隆此存储库```sh

git clone https://github.com/antonsokolskyy/SSMCP.git


### 2.创建.env文件```sh
cd SSMCP/
cp .env.example .env

3.设置SearXNG

启动和停止 searxng 要生成的容器 settings.yml:```sh
docker compose up searxng


等到你看到:```
"/etc/searxng/settings.yml" does not exist, creating from template...

然后按下 Ctrl+C 阻止它。

编辑 deploy/docker/searxng_data/settings.yml 并添加 json 到 formats 列表:```yaml

remove format to deny access, use lower case.

formats: [html, csv, json, rss]

formats:
- html
- json


### 4.构建SSMCP映像```sh
docker compose build

5.运行全栈```sh

docker compose up -d


### YouTube Cookie(可选)

要访问年龄限制或私人YouTube视频,并减少点击验证码或IP阻止的机会,您可以从浏览器提供Cookie。

**注:** cookie文件必须采用Netscape cookie格式。

Generating cookies.txt

**选项1:使用浏览器扩展**

为您的浏览器安装一个扩展程序(如“本地获取cookies.txt”),并以Netscape格式导出youtube.com的Cookie。

**选项2:使用yt-dlp二进制文件**```sh
yt-dlp --cookies-from-browser chrome --cookies cookies.txt https://www.youtube.com/watch?v=VIDEO_ID

替换 chrome 使用您的浏览器(firefox, edge, safari等等)。这将自动以Netscape格式导出。

Using cookies.txt

放置生成的 cookies.txt 文件位于:```
deploy/docker/ssmcp/cookies.txt


**安全警告:** Cookie文件包含身份验证令牌和敏感数据。设置适当的文件权限以防止未经授权的访问:```sh
chmod 600 deploy/docker/ssmcp/cookies.txt

Docker容器会自动检测并使用该文件。

MCP网址

服务器使用流式HTTP传输。连接到MCP服务器:```
http://{HOST}:{PORT}/mcp


例子:```
http://localhost:8000/mcp

与MCP客户端一起使用

LM 工作室```json

{
"mcpServers": {
"ssmcp": {
"url": "http://localhost:8000/mcp"
}
}
}


## Web用户界面

SSMCP包括一个可选的Web UI,用于监视请求和响应。这对于调试和检查模型如何使用工具特别有用。

Enabling the Web UI

1. **配置Redis**:打开你的 `.env` 归档并取消注释 `REDIS_URL` 线路:```env
REDIS_URL=redis://redis:6379
  1. 启用服务:打开 docker-compose.yml (以及 docker-compose.dev.yml 如果使用开发模式)并取消注释 redis 和 ssmcp-ui 服务块。

  2. 重启服务:```sh
    make build


5. **访问监视器**:打开 http://localhost:8081 在您的浏览器中。

## 工具

### 网络搜索

执行网络搜索并返回包含提取内容的相关结果。

**参数:**

- `query` (str):搜索查询或关键字以查找相关网络内容

**退货:**

- 结果列表,每个结果包含:
- `url` (str):网页URL
- `content` (str):Markdown格式的页面内容

### web_fetch

从指定的URL获取内容并将其转换为Markdown。

**参数:**

- `url` (str):从中获取内容的URL

**退货:**

- 包含Markdown格式页面内容的字符串

### youtube_get_字幕

从YouTube视频中获取字幕/说明,并返回文本内容。

**参数:**

- `url` (str):用于获取字幕的YouTube视频URL

**退货:**

- 包含带时间戳的字幕的字符串,格式为:\[HH:MM:SS\]文本

## 搜索工作原理

SSMCP使用管道从网络搜索中提供干净的内容:

### 1.搜索(SearXNG)

- 查询被发送到本地 瑟克斯NG 例子
- SearXNG汇总了来自多个搜索引擎的结果
- 返回包含标题和代码段的URL列表

### 2.内容提取(Crawl4AI)

- 每个URL都是使用无头Chromium浏览器获取的
- 页面完全呈现(JavaScript执行,动态内容加载)
- 提取原始内容
- 所有URL都会同时处理

### 3.内容过滤

两级过滤提取清洁主要内容:

1. **CSS选择器筛选器** -尝试选择器(`article`, `main`等)以找到主要内容区域
1. **残留垃圾过滤器** -删除UI工件(工具提示、重复文本)

如果任何过滤器产生输出,则过滤后的HTML将通过Crawl4AI重新处理,以便在markdown转换之前获得更清晰的输出。

### 4.Markdown转换

- 将过滤后的HTML转换为干净的Markdown
- 删除图像和外部链接

### 5.可选:LLM摘要

启用后,SSMCP使用LLM来汇总搜索结果,然后将其返回给您的AI模型。这减少了上下文窗口中的令牌计数——搜索结果可能是40k-60k个令牌,但摘要大大减少了这一点。

**注:** 默认情况下禁用LLM摘要。如果需要,可以通过环境变量启用它(请参阅 `.env.example`).

## 发展

所有开发任务都在Docker容器内执行。除了Docker和Docker Compose之外,不需要在主机上安装任何东西。

### 可用的生成命令

跑 `make help` 查看所有可用命令:

Development Workflow

0. **启用开发模式:**\
打开 `.env` 并取消注释该行```
COMPOSE_FILE=docker-compose.yml:docker-compose.dev.yml
  1. 启动服务:```sh
    make build

1. **打开容器中的外壳:**```sh
make shell

在shell中,您可以运行任何命令:```sh
uv run python -m ssmcp.server
uv run pytest -v


1. **在主机上编辑代码** -更改会通过卷装载自动反映在容器中

1. **运行测试:**```sh
make test
  1. 检查代码质量(lint+类型检查):```sh
    make check

1. **如果需要,请重新启动或重建:**```sh
make restart
make rebuild
  1. 停止服务:```sh
    make down

## 配置

所有配置都通过环境变量进行管理。看 `.env.example` 有关可用选项

## OpenWebUI OAuth身份验证

SSMCP支持OAuth身份验证,可与OpenWebUI和任何符合OIDC的身份提供程序一起使用。

### OpenWebUI OAuth的工作原理

当您选择 **OAuth** 在MCP服务器的OpenWebUI中:

- OpenWebUI将系统用户的OAuth访问令牌转发到 `Authorization: Bearer ` 头球
- 令牌是一个JWT,其中包含来自身份提供者的用户信息
- SSMCP验证令牌并从中提取用户标识符 `sub` 声称

Enabling OAuth

要启用OAuth身份验证,请在您的 `.env` 文件:```bash
# Enable OAuth authentication
OAUTH_ENABLED=true

# JWKS endpoint URL for your identity provider's public keys
# Examples:
#   Authentik: https://authentik.example.com/application/o/my-app/jwks
OAUTH_JWKS_URL=https://your-idp.example.com/path/to/jwks

# Issuer URL for token issuer verification
# Must match the 'iss' claim in JWT tokens
# Examples
#   Authentik: https://authentik.example.com/application/o/my-app
OAUTH_ISSUER=https://your-idp.example.com/application/o/my-app

# Open WebUI client ID for token audience verification
OAUTH_CLIENT_ID=your-openwebui-client-id

Token Validation

启用OAuth后,SSMCP会验证:

  1. JWT签名:使用来自JWKS端点的身份提供程序的公钥验证令牌签名
  2. 发行人:验证 iss 索赔匹配 OAUTH_ISSUER
  3. 过期:验证 exp claims-拒绝过期的令牌
  4. 观众:验证 aud 索赔匹配 OAUTH_CLIENT_ID
  5. 主题:需要 sub 声明(包含用户标识符)

OpenWebUI Configuration

在OpenWebUI中,使用以下配置MCP服务器:

  • 类型:MCP流式HTTP
  • 统一资源定位符:您的SSMCP服务器URL(例如。, http://ssmcp:8000/mcp)
  • 认证:OAuth
  • 系统将自动转发用户的OAuth令牌

Supported Identity Providers

SSMCP与任何符合OIDC标准的身份提供者合作,这些提供者:

  • 为公钥分发提供JWKS端点
  • 使用RS256签名发出JWT访问令牌
  • 包括标准索赔(sub, aud, exp, iss)

许可证

Apache许可证2.0-请参阅 许可证 文件以获取详细信息。

常见问题

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

在客户端按下面的安装命令接入:uv run python -m ssmcp.server。装完在客户端配置里引用同一个包或端点。

SSMCP (Antonsokolskyy) 怎么在 Claude 里配置?

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

SSMCP (Antonsokolskyy) 收费吗?

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

SSMCP (Antonsokolskyy) 需要 API Key 吗?

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

SSMCP (Antonsokolskyy) 支持哪些客户端?

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

SSMCP (Antonsokolskyy) 能提供哪些能力?

资料显示约 3 个工具;能力标签包括 搜索、内容提取、Python、Claude、自托管。具体工具清单以官方文档为准。

SSMCP (Antonsokolskyy) 需要什么运行环境?

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

SSMCP (Antonsokolskyy) 是本地还是远程?

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

热门专题

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

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