Skip to main content
Glama
honlnk

linkseek

by honlnk
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

linkseek

自托管的远程 MCP 服务，通过 HTTP 提供「联网搜索 + 网页获取」能力给 AI 编程工具（Claude Code / Cursor 等），并配套网页端管理后台。

已实现功能

MCP 服务（给 AI 工具调用）

  • ✅ 4 个 MCP 工具：web_search / web_fetch / web_search_and_fetch / web_fetch_render

  • ✅ Streamable HTTP 传输（单一 /mcp 端点）

  • ✅ API Key 鉴权（Bearer Token）

  • ✅ SSRF 防护（IP 范围拦截 + DNS rebinding 防护 + 重定向逐跳校验）

  • ✅ HTML → Markdown 转换（正文提取 + 噪音去除）

  • ✅ SearXNG 元搜索引擎集成

管理后台（网页端）

  • ✅ 管理员密码登录（argon2 哈希 + session cookie）

  • ✅ Key 管理：创建 / 列表 / 启停 / 删除

  • ✅ 请求总览：总请求数、按工具分布、近 14 天趋势

  • ✅ 单 Key 用量统计：按工具分布 + 趋势图

  • ✅ 用量自动记录：每次 MCP 工具调用写入数据库

基础设施

  • ✅ MySQL 8.0 + Prisma ORM（数据持久化）

  • ✅ 用量统计（每次调用自动记录 keyId / toolName / 时间）

  • ✅ Vue 3 + Naive UI 管理界面（SPA）

Related MCP server: Local-MCP-server

快速开始

1. 安装依赖

pnpm install

2. 启动依赖容器（MySQL + SearXNG）

docker compose up -d
# 等待 MySQL 就绪（约 5 秒）

3. 配置环境变量

cp .env.example .env
# 编辑 .env：
# - ADMIN_PASSWORD：管理员登录密码（首次 seed 用）
# - SESSION_SECRET：会话密钥（openssl rand -hex 32 生成）

4. 初始化数据库

pnpm db:deploy    # 执行迁移建表
pnpm db:seed      # 初始化管理员账号

5. 构建前端 + 启动服务

pnpm web:build    # 构建管理后台 SPA
pnpm dev          # 启动后端（含 MCP + REST API + 静态托管）

访问 http://localhost:3000 进入管理后台。

开发模式（前后端分离热重载）

# 终端 1：后端
pnpm dev

# 终端 2：前端（Vite dev server，代理 /api 到 3000）
pnpm web:dev
# 访问 http://localhost:5173

使用流程

  1. 浏览器打开 http://localhost:3000，用 ADMIN_PASSWORD 登录

  2. 在「Key 管理」新建一个 Key（明文只显示一次，立即保存）

  3. 把 Key 配置到 AI 工具：

    {
  "mcpServers": {
    "linkseek": {
      "url": "http://localhost:3000/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

  4. AI 工具调用工具后，在「请求总览」和「Key 详情」查看用量

验证

# 健康检查
curl http://localhost:3000/health

# MCP 握手（需替换 YOUR_API_KEY）
curl http://localhost:3000/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}},"id":1}'

工具说明

工具

功能

关键参数

web_search

联网搜索

query, maxResults, timeRange(day/month/year), language

web_fetch

获取网页正文（Markdown）

url

web_search_and_fetch

搜索 + 批量获取正文

query, fetchCount, searchMaxResults

web_fetch_render

无头浏览器渲染获取 JS 动态页面（SPA），返回 Markdown

url

安全说明

  • API Key：以 SHA-256 哈希存储在数据库，明文仅在创建时返回一次

  • 管理员密码：argon2id 哈希存储

  • SSRF 防护：阻断 RFC1918 私有地址、169.254.169.254（云元数据）、loopback 等危险范围；自定义 DNS lookup 固定解析结果防 rebinding；重定向逐跳重新校验

  • 浏览器渲染的 SSRF 防护：web_fetch_render 依赖独立 browser-fetch 微容器，微容器内部自行做 URL 校验 + DNS 解析过滤（浏览器自己做 DNS 会绕过主服务防护），用安全 IP 直连 + 原 Host 头

  • SSRF_STRICT：设为 true 额外阻断 reserved/multicast 段（生产服务器推荐；开发机用 fake-ip 代理时保持 false）

项目结构

├── prisma/                  # 数据库 schema + 迁移 + seed
├── src/                     # 后端（Node.js + Express + TypeScript）
│   ├── index.ts             # 入口：MCP + REST API + 静态托管
│   ├── config.ts            # 环境变量校验
│   ├── lib/prisma.ts        # Prisma 客户端单例
│   ├── auth/                # 鉴权（KeyStore / verifier / session）
│   ├── admin/               # 管理 REST API（auth/keys/stats 路由）
│   ├── tools/               # MCP 工具实现
│   ├── search/              # SearXNG 搜索
│   ├── fetch/               # 网页获取 + SSRF 防护
│   └── utils/               # 日志 + 用量记录
├── web/                     # 管理后台 SPA（Vue 3 + Naive UI + Vite）
│   └── src/views/           # 登录 / 总览 / Key列表 / Key详情
├── searxng/                 # SearXNG 配置
├── browser-fetch/           # 浏览器渲染微容器（Playwright + Chromium，独立进程）
│   └── src/                 # Express /render 服务 + SSRF 防护
└── docker-compose.yml       # MySQL + SearXNG + browser-fetch（本地开发）

This server cannot be installed

F
license - not found
-
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/honlnk/linkseek'

If you have feedback or need assistance with the MCP directory API, please join our Discord server