# YYSK MCP Server - 企业内部知识库助手
这是一个基于 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 实现的企业内部知识库服务。它允许 AI 模型检索公司内部的 Wiki、规章制度和通知，并提供了一个美观的管理后台。
## 🌟 核心特性
- **双模支持**: 支持本地 `stdio` 传输（Claude Desktop 等使用）和远程 `sse` 传输。
- **内容管理**: 内置基于 React 的现代感管理后台，支持 Markdown。
- **高效检索**: 基于 SQLite 数据库，支持分类检索和关键词搜索。
- **快速开发**: 使用 `FastMCP` 开发，易于扩展工具 (Tools) 和资源 (Resources)。
## 🛠️ 技术栈
- **后端**: TypeScript, FastMCP, Express, Drizzle ORM, Better-SQLite3
- **前端**: React, Vite, Tailwind CSS, Lucide Icons
## 🚀 快速开始
### 1. 安装依赖
```bash
npm install
```
### 2. 启动服务 (本地模式)
用于 IDE 或 Claude Desktop 插件，默认启动 CMS 在 `http://localhost:3000`。
```bash
npm run dev
```
### 3. 启动服务 (远程模式)
启动 MCP SSE 服务 (端口 3000) 和 CMS 管理后台 (端口 3001)。
```bash
npm run dev -- --sse
```
### 4. 启动管理后台前端 (开发态)
```bash
npm run cms:dev
```
## 📂 结构说明
- `src/index.ts`: 程序入口，包含 MCP 服务定义和 CMS API。
- `src/db/`: 数据库 Schema 和连接配置。
- `src/cms/client/`: 管理后台前端代码。
- `sqlite.db`: 自动生成的数据库文件。
## 🔧 配置 MCP 客户端 (示例)
在 `Claude Desktop` 中添加以下配置：
```json
{
"mcpServers": {
"yysk-wiki": {
"command": "node",
"args": ["/path/to/yysk-mcp-server/dist/index.js"]
}
}
}
```
## 📝 开发计划
- [ ] 支持向量检索 (Vector Search)
- [ ] 接入 LDAP/OIDC 内部统一鉴权
- [ ] 支持上传 PDF/Word 文档自动解析并存入知识库
