york (Linyork)

MCP搜索检索

提供方 linyork

搜索检索 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaude
查看接入方式

York 是一个专为 AI Agent 设计的项目知识管理工具,提供语义搜索、结构感知与长期记忆管理等核心功能,适用于AI项目开发与知识管理。

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

支持客户端

适用场景

AI知识管理Python本地部署语义搜索结构感知长期记忆管理向量数据库

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
uv run pytest

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

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

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

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

资料聚合

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

情报与竞品检索

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

选择建议

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

值得选的地方

  • 资料标注 12 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
york (Linyork)当前 12 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

服务器档案

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

详细介绍

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

🤖 York (The AI Project Brain)

York 是一個專為 AI Agent 設計的「專案知識管理大腦」。它透過 Model Context Protocol (MCP) 為 Claude 等 AI 提供深度專案認知能力,包含語意搜尋、結構感知與長期記憶管理。

✨ 核心特色

  1. 🧠 雙腦協作架構 (Cognitive Architecture)
    * 結構認知 (Structure): 自動偵測專案框架 (Laravel, FuelPHP, React...) 並理解目錄意義。
    * 知識記憶 (Knowledge): 儲存業務邏輯、開發規範與決策紀錄。

  2. 🔍 混合檢索系統 (Hybrid Search)
    * 結合 關鍵字搜尋 (BM25) 與 語意搜尋 (Vector Embedding)。
    * 使用 RRF (Reciprocal Rank Fusion) 演算法優化排序。

  3. ⚡ 高效能 Python 核心
    * 基於 FastMCP 與 uv 套件管理。
    * 內建 LanceDB 向量資料庫(無須額外安裝 Service)。
    * 支援 SentenceTransformers 本機 Embedding 模型。


🚀 快速開始 (Docker 部署)

1. 建置 Docker Image```bash

./build-image.sh


### 2. 設定 Claude Code / Claude Desktop

#### macOS/Linux — Claude Code

在 `~/.claude/mcp.json` 加入(不存在則新建):```json
{
"mcpServers": {
"york": {
"command": "/你的/絕對路徑/york/start.sh"
}
}
}

macOS/Linux — Claude Desktop

設定檔位置: `~/Library/Application Support/Claude/claude_desktop_config.json````json
{
"mcpServers": {
"york": {
"command": "/你的/絕對路徑/york/start.sh"
}
}
}


#### Windows — Claude Desktop / Antigravity```json
{
"mcpServers": {
"york": {
"command": "powershell.exe",
"args": ["-NoProfile", "-ExecutionPolicy", "Bypass", "-File", "C:\\你的路徑\\york\\start.ps1"]
}
}
}

3. 重啟 Claude

重啟後應在 🛠️ 圖示中看到 York 的工具。


⚙️ 環境設定

所有資料預設存放在專案內的 .data/ 目錄(已加入 .gitignore):```
york/.data/
├── lancedb/ ← 向量資料庫
└── {project_name}/ ← 知識 Markdown 檔案
└── *.md


如需自訂路徑,複製 `.env.example` 為 `.env` 並設定:```bash
cp .env.example .env
環境變數 預設值 說明
PROJECTS_DIR 必填 本機專案根目錄
YORK_KNOWLEDGE_ROOT ./data 知識庫 md 檔存放路徑
YORK_VECTOR_DB_PATH ./data/lancedb LanceDB 向量資料庫路徑
ALLOWED_PROJECTS 空(允許全部) 逗號分隔的允許專案名稱

🛠️ 可用工具 (MCP Tools)

York 提供 12 個工具,分為三大類:

📚 知識管理 (Knowledge)

工具名稱 描述
save_knowledge_tool 儲存文件到知識庫,並自動同步向量索引
read_knowledge_tool 讀取特定知識文件的內容與 metadata
list_knowledge_tool 列出專案中的所有知識文件
delete_knowledge_tool 刪除知識文件與對應的向量數據
get_project_knowledge_tool 取得專案的完整知識彙整 (project-knowledge.md)

🔍 搜尋與檢索 (Retrieval)

工具名稱 描述
search_knowledge_tool 混合搜尋 (關鍵字+語意),支援 RRF 排序與結構化過濾
reindex_knowledge_tool 手動觸發特定專案的索引重建
get_vector_db_stats_tool 查看向量資料庫狀態 (統計、快取命中率)

🏗️ 結構認知 (Structure)

工具名稱 描述
detect_project_structure_tool 自動偵測專案框架並生成 project.structure.yml 建議
get_project_structure_tool 讀取目前的專案結構配置
save_project_structure_tool 儲存結構配置並觸發結構索引更新
list_projects_tool 列出此工作區管理的所有專案

🔗 可用資源 (Resources - 支援 @ 引用)

URI 模式 用途
project://{name}/structure 讀取專案目前的目錄結構與架構說明
project://{name}/knowledge/{file} 讀取特定的知識文件

📂 專案結構```

york/
├── src/
│ ├── agent_server/ # MCP Server 定義與入口
│ ├── knowledge/ # 知識管理核心 (CRUD, Sync, Search)
│ ├── services/ # 基礎服務 (VectorStore: Singleton + LRU)
│ ├── structure/ # 結構認知核心 (Detector, YAML Handler)
│ ├── models/ # Pydantic 資料模型定義
│ └── utils/ # 通用工具 (Logger, Project Helper)
├── scripts/ # 功能演示腳本
├── tests/ # Pytest 測試套件
├── .data/ # 本機資料 (gitignored)
│ ├── lancedb/ # 向量資料庫
│ └── {project}/ # 知識 md 檔
├── Dockerfile
├── start.sh # 容器啟動腳本 (macOS/Linux)
├── start.ps1 # 容器啟動腳本 (Windows)
└── build-image.sh # Docker Image 建置


---

## 🔧 維運工具

工具 · macOS/Linux · Windows · 用途
知識庫儀表板 · `./dashboard.sh` · `.\dashboard.ps1` · 視覺化瀏覽知識庫(`http://localhost:8501`)
資料庫檢查 · `./inspect_db.sh` · `.\inspect_db.ps1` · 查看向量資料庫詳細內容
重建索引 · `./migrate_knowledge.sh` · `.\migrate_knowledge.ps1` · 強制重建所有專案的向量索引
資料庫管理 · `./ops_db.sh [backup\ · reset]` · `.\ops_db.ps1 [backup\ · reset]` · 備份或重置 LanceDB
測試 · `./test.sh` · `.\test.ps1` · 執行完整測試套件

---

## 📝 開發者指南

若您想在本機直接開發(不使用 Docker):```bash
# 安裝 uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# 安裝依賴
uv sync --all-extras

# 執行測試
uv run pytest

# 啟動 Server
uv run python -m src

常见问题

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

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

york (Linyork) 怎么在 Claude Desktop、Claude 里配置?

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

york (Linyork) 收费吗?

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

york (Linyork) 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

york (Linyork) 支持哪些客户端?

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

york (Linyork) 能提供哪些能力?

资料显示约 12 个工具;能力标签包括 Python、Claude、搜索。具体工具清单以官方文档为准。

york (Linyork) 需要什么运行环境?

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

york (Linyork) 是本地还是远程?

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

热门专题

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

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