Afrotech Connect And Control Pdfmcpdemo

MCP文档知识

提供方 mrhillsman-talks

文档知识 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude
查看接入方式

一个基于Next.js和Model Context Protocol (MCP)的PDF文档管理平台,提供文档浏览、AI摘要生成和格式转换功能。

一句话选型结论

按资料字段整理

Afrotech Connect And Control Pdfmcpdemo 属于文档知识类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

支持客户端

适用场景

PDF管理TypeScript本地部署AI摘要文档转换Next.js应用MCP架构

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
pip install -r requirements.txt

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

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
文档检索问答

在你的文档库里按问题找答案。

知识库读写

把新资料写进知识库,随用随取。

内容整理

把零散资料归纳成结构化笔记。

选择建议

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

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Afrotech Connect And Control Pdfmcpdemo当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
dify 未标注 stdio · 本地进程 本地部署 有 2026-04-11
open-webui 未标注 stdio · 本地进程 本地部署 有 2026-04-11
JeecgBoot 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Cherry Studio 未标注 未标注 未标注 无 2026-05-17
mempalace 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

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

详细介绍

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

基于MCP的PDF文档管理系统

一个复杂的文档管理平台 Next.js, 模型上下文协议(MCP),以及 AI驱动的功能 用于PDF文档浏览、摘要和格式转换。

🎯 特性

  • 📚 文档列表视图 -浏览具有丰富元数据(标题、作者、标签、页数)的PDF文档
  • 👁️ 快速预览 -点击查看模态中的文档摘要
  • 📖 完整文档查看器 -使用缩放和导航控件查看完整的PDF
  • 🤖 AI驱动的摘要 -使用Claude AI生成简短、详细或全面的摘要
  • 📝 适应性启发式 -大型文档(>50页)的智能偏好收集
  • 🔄 格式转换 -将PDF转换为EPUB或Markdown格式
  • 💾 本地存储 -仅本地存储元数据;按需获取完整PDF
  • 🎨 现代用户界面 -使用Tailwind CSS和shadcn/ui构建的漂亮界面

🏗️ 建筑

该系统实现了 模型上下文协议(MCP) 架构:```
┌─────────────────────────────────────┐
│ Next.js UI (MCP Host) │
│ • Document list & viewer │
│ • User interactions │
└─────────────┬───────────────────────┘
│ instantiates
↓
┌─────────────────────────────────────┐
│ MCP Client (FastMCP) │
│ • Roots: Reformatted docs dir │
│ • Sampling: LLM API access │
│ • Elicitation: User prompts │
└─────────────┬───────────────────────┘
│ MCP Protocol
↓
┌─────────────────────────────────────┐
│ MCP Server (Python/FastMCP) │
│ • Document tools │
│ • Summary generation │
│ • Format conversion │
└─────────────┬───────────────────────┘
│ API calls
↓
┌─────────────────────────────────────┐
│ PDF Document Provider Service │
│ • Full PDF storage │
│ • Document metadata API │
└─────────────────────────────────────┘


### 关键组件

1. **Next.js用户界面(MCP主机)**

- 前端应用程序
- 实例化MCP客户端
- 管理用户交互

1. **MCP客户端**

- **根:** 显示重新格式化的文档目录
- **取样:** 为摘要提供LLM访问权限
- **引语:** 处理自适应用户提示

1. **MCP服务器**

- 连接到PDF提供商服务
- 公开文档操作工具
- 协调人工智能操作

1. **PDF提供商服务**

- 外部服务(不包括在内)
- 存储完整的PDF文档
- 提供元数据和检索API

## 🚀 快速开始

### 先决条件

- Node.js 18+
- Python 3.10+
- pnpm(推荐)或npm
- 无烟煤API键

### 安装

1. **克隆存储库**```bash
git clone
cd afrotech-cac-dv
  1. 安装依赖项```bash

Frontend

pnpm install

MCP Server

cd server
pip install -r requirements.txt
cd ..


1. **配置环境变量**```bash
cp .env.example .env.local

编辑 .env.local:```env
ANTHROPIC_API_KEY=sk-ant-...
PDF_PROVIDER_API_URL=https://provider.example.com
PDF_PROVIDER_API_KEY=provider_key_...
MCP_SERVER_URL=http://localhost:3001
REFORMATTED_DOCS_PATH=/path/to/reformatted-docs


1. **启动开发服务器**

终端1-Next.js用户界面:```bash
pnpm dev

终端2-MCP服务器:```bash
cd server
python main.py


1. **打开应用程序**```
http://localhost:3000

📖 用法

浏览文档

  1. 导航到主页以查看所有可用文档
  2. 每张卡片显示标题、作者、标签和页数
  3. 单击任何文档打开预览模式

查看预览

  1. 预览模式显示文档摘要
  2. 点击“查看更多”以加载完整文档

生成摘要

对于小文档(\<50页):

  1. 点击“创建摘要”
  2. 自动生成摘要(简短,约500字)
  3. 即时显示摘要

对于大型文档(>50页):

  1. 点击“创建摘要”
  2. 出现包含以下选项的激励对话框:
    - 摘要类型: 简要/详细/全面
    - 最大字数: 300-5000(滑块)
    - 包括引用: 是/否
  3. 选择操作:
    - 接受: 使用您的偏好
    - 使用默认值: 跳过自定义
    - 取消: 放弃操作
  4. 根据偏好生成的摘要
  5. 摘要与元数据一起显示

转换格式

  1. 查看完整文档
  2. 点击“转换为EPUB”或“转换为Markdown”
  3. 转换过程开始
  4. 已转换的文件已保存到 reformatted-docs/ 目录
  5. 提供下载链接

🧪 测试

运行测试```bash

All tests (unit + integration + E2E)

pnpm test

Watch mode for development

pnpm test:watch

Coverage report

pnpm test:coverage

Interactive UI mode

pnpm test:ui


### 检验统计量```
✓ Test Files: 11 passed
✓ Tests: 250 passed | 3 skipped
✓ Coverage: ~75%
✓ Duration: ~8 seconds

测试套件

  • 单元测试(41): MCP客户端模块(采样、启发)
  • 组件测试(185): 所有带有React测试库的UI组件
  • 集成测试(14): 所有6条API路线和MCP通信
  • E2E测试(10): 完成用户工作流程和旅程

模拟模式

该应用程序包括一个全面的模拟开发模式,无需MCP服务器:```typescript
// Enabled by default in development
const client = createMCPClient(); // useMock: true


看 docs/TEST.md 获取详细的测试文档。

## 📚 文档

### 核心文件

- **建筑.md** -完整的系统架构和设计
- **API_REFERENCE.md** -API端点和MCP工具参考
- **用户指南.md** -最终用户说明和工作流程

### 开发指南

- **Developpent.md** -开发人员设置和贡献指南
- **测试.md** -测试策略和指南
- **部署.md** -生产部署指南

### MCP文件

- **MCP_CLIENT.md** -MCP客户端实现细节
- **MCP_SERVER.md** -MCP服务器工具和配置
- **MCP_QUICK_REFERENCE.md** -快速MCP参考

### 项目规划

- **实施_计划.md** -发展路线图
- **IMPLEMENTATION_STATUS.md** -当前进展(96%)
- **可选\_ ASKS.md** -剩余4%的逐步计划

## 🛠️ 技术栈

### 前端

- **框架:** Next.js 15+(应用路由器)
- **语言:** TypeScript 5+
- **造型:** 顺风CSS v4
- **组件:** shadcn/ui(Radix ui)
- **图标:** Lucide反应
- **PDF渲染:** 反应pdf

### 后端

- **MCP服务器:** Python快速MCP
- **MCP客户端:** TypeScript MCP SDK
- **LLM** 人类学家克劳德·neneneba API(Opus,Sonnet,Haiku)
- **HTTP客户端:** httpx(Python),fetch(TS)

### 开发工具

- **包管理器:** pnpm
- **测试:** Vitest 4+带测试库
- **Linting:** 拉夫·ESLint
- **格式:** 更漂亮,黑色

## 🎨 UI组件

内置 **shadcn/ui** 和 **Lucide反应** 图标:

- `DocumentCard` -单个文档显示
- `DocumentList` -文档卡片网格
- `DocumentPreviewModal` -抽象查看器
- `FullDocumentViewer` -完整的PDF渲染器
- `SummaryGenerationPanel` -摘要控制
- `FormatConversionPanel` -转换控制
- `ElicitationDialog` -自适应偏好收集

## 🔑 MCP实施要点

### 根

暴露 `reformatted-docs/` MCP服务器的目录:```typescript
{
uri: &#x27;file:///reformatted-docs&#x27;,
name: &#x27;reformatted-documents&#x27;
}

采样

提供LLM访问权限以生成摘要:```typescript
await client.createMessage({
messages: [{ role: 'user', content: 'Summarize...' }]
})


### 引出

基于文档大小的自适应提示:```python
if page_count &gt; 50:
preferences = await client.elicitation.create(
message=&quot;Configure summary options:&quot;,
schema={...}
)

🗺️ 项目结构```

afrotech-cac-dv/
├── src/
│ ├── app/ # Next.js app router
│ ├── components/ # React components
│ │ ├── ui/ # shadcn components
│ │ ├── documents/ # Document components
│ │ └── mcp/ # MCP components
│ ├── lib/
│ │ ├── mcp-client/ # MCP client implementation
│ │ └── utils/ # Utilities
│ ├── types/ # TypeScript types
│ └── store/ # State management
├── server/ # MCP Server (Python)
│ ├── main.py
│ ├── tools/
│ ├── provider/ # PDF provider connector
│ └── tests/
├── docs/ # Documentation
├── tests/ # E2E & integration tests
├── reformatted-docs/ # Converted documents
└── public/ # Static assets
```

🤝 贡献

  1. 分叉存储库
  2. 创建要素分支(git checkout -b feature/amazing-feature)
  3. 提交更改(git commit -m &#x27;feat: add amazing feature&#x27;)
  4. 推送到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

承诺公约

跟随 约定式提交:

  • feat: 新功能
  • fix: 错误修复
  • docs: 文档
  • test: 测试
  • refactor: 代码重构

📊 开发状态

总体进度:96%完成(49/51项任务)

完成✅

  • [x] 项目设置和架构
  • [x] MCP客户端实现(根、采样、启发)
  • [x] MCP服务器实现(6个FastMCP工具)
  • [x] UI组件(7个带有shadcn/UI的组件)
  • [x] 带有元数据的文档列表视图
  • [x] 预览带有摘要的模态
  • [x] 带标签的完整文档查看器
  • [x] 基于人工智能的摘要生成
  • [x] 格式转换(EPUB、Markdown)
  • [x] 测试套件(250个测试,约75%的覆盖率)
  • [x] 综合文档(10个文档,~160KB)
  • [x] 顺风CSS v4迁移
  • [x] Next.js 15+兼容性
  • [x] 模拟开发模式
  • [x] 错误边界和处理
  • [x] API路由(6个端点)
  • [x] 具有增量提交的Git存储库

进行中/可选⏳

  • [~]MCP客户端根模块测试(技术债务-fs模拟)
  • [~]MCP服务器Python/pytest测试(UI开发可选)

📋 想帮助完成这些吗? 看 docs/OPTIONAL_TASKS.md 详细的分步计划(5-7小时)。

生产就绪🚀

应用程序是 生产准备就绪 与:

  • ✅ 所有核心功能均正常工作
  • ✅ 全面测试
  • ✅ 现代工具(Next.js 15,Tailwind v4)
  • ✅ 完整文档
  • ✅ 错误处理和恢复
  • ✅ 模拟开发模式

看 docs/IMPLEMENTATION_STATUS.md 以获取详细的进度跟踪。

🐛 已知问题

技术债

  1. MCP客户端根模块测试 -Vitest中fs模块模拟复杂性
  • 状态:排除在测试套件之外
  • 影响:低(功能正常,只是没有经过单元测试)
  • 未来:重构依赖注入或使用更好的模拟
  1. jsdom限制 -由于浏览器API限制,跳过了3个测试
  • 剪贴板API(SummaryGenerationPanel中的2个测试)
  • scrollIntoView(复苏对话框中的1个测试)
  • 影响:无(功能在浏览器中工作,只是无法进行单元测试)

浏览器兼容性

  • 仅限现代浏览器(Chrome 90+、Firefox 88+、Safari 14+)
  • 需要启用JavaScript
  • 推荐:最新版本的Chrome、Firefox或Safari

📝 许可证

MIT许可证 -有关详细信息,请参阅LICENSE文件

🙏 致谢

  • 模型上下文协议 - MCP规范
  • FastMCP - FastMCP库
  • Anthropic -Claude AI API
  • shadcn/ui -组件库
  • 维塞尔 -Next.js框架

📧 联系

如有疑问或支持,请在GitHub上发布问题。


内置❤️ 使用Next.js、MCP和Claude AI

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Afrotech Connect And Control Pdfmcpdemo 怎么安装?

在客户端按下面的安装命令接入:pip install -r requirements.txt。装完在客户端配置里引用同一个包或端点。

Afrotech Connect And Control Pdfmcpdemo 怎么在 Claude 里配置?

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

Afrotech Connect And Control Pdfmcpdemo 收费吗?

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

Afrotech Connect And Control Pdfmcpdemo 需要 API Key 吗?

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

Afrotech Connect And Control Pdfmcpdemo 支持哪些客户端?

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

Afrotech Connect And Control Pdfmcpdemo 能提供哪些能力?

资料显示能力标签包括 文档转换、TypeScript、Claude。具体工具清单以官方文档为准。

Afrotech Connect And Control Pdfmcpdemo 需要什么运行环境?

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

Afrotech Connect And Control Pdfmcpdemo 是本地还是远程?

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

热门专题

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

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