Jackgic MCP

MCP文档知识

提供方 jackgic

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

基于Python MCP框架开发的文档格式转换服务,支持通过HTTP方式调用,将Markdown文本转换为Word文档,并提供临时有效的下载链接。

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

适用场景

文档转换Python本地部署Markdown转WordHTTPAPI临时文件管理OpenAPI规范

安装与配置

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

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

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

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

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

知识库读写

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

内容整理

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

选择建议

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

值得选的地方

  • 资料标注 1 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

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

服务器档案

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

详细介绍

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

MCP 文档转换服务

基于 Python MCP 框架开发的文档格式转换服务,支持通过 HTTP 方式调用,将 Markdown 文本转换为 Word 文档,并提供临时有效的下载链接(2小时有效期)。

功能特性

  • ✅ Markdown 到 Word 转换:支持标题、段落、列表、表格、代码块等常见Markdown元素
  • ✅ HTTP API 接口:基于 Starlette 框架,提供 RESTful API
  • ✅ MCP 协议支持:完全兼容 MCP (Model Context Protocol) 规范
  • ✅ 临时文件管理:自动清理过期文件,默认2小时有效期
  • ✅ OpenAPI 规范:提供完整的 API 文档
  • ✅ CORS 支持:允许跨域访问

快速开始

1. 安装依赖```bash

pip install -r requirements.txt


### 2. 启动服务```bash
python server.py

服务将在 http://localhost:8000 启动。

3. 访问 API 文档

打开浏览器访问:
- OpenAPI 规范:http://localhost:8000/openapi.json
- 健康检查:http://localhost:8000/health

API 使用示例

1. 健康检查```bash

curl http://localhost:8000/health


响应:```json
{
  "status": "healthy",
  "service": "MCP Document Converter",
  "version": "1.0.0",
  "timestamp": "2025-11-05T23:17:01.000000"
}

2. 转换 Markdown 到 Word(通过 MCP)```bash

curl -X POST http://localhost:8000/mcp/v1/messages \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "markdown_to_word",
"arguments": {
"markdown_content": "# 标题\n\n这是一个段落。\n\n## 子标题\n\n- 列表项1\n- 列表项2",
"filename": "my_document"
}
}
}'


### 3. 列出所有文件```bash
curl http://localhost:8000/files

响应:```json
{
"files": [
{
"file_id": "uuid-here",
"filename": "my_document_uuid.docx",
"download_url": "/download/uuid-here",
"created_at": "2025-11-05T23:17:01.000000",
"expiry_time": "2025-11-06T01:17:01.000000"
}
],
"count": 1
}


### 4. 下载文件```bash
curl -O http://localhost:8000/download/{file_id}

MCP 工具说明

markdown_to_word

将 Markdown 文本转换为 Word 文档。

输入参数:
- markdown_content (必需): Markdown 格式的文本内容
- filename (可选): 输出文件名,默认为 "document"

返回:
- 成功消息,包含文件ID、下载链接、过期时间等信息

支持的 Markdown 元素

  • 标题 (H1-H6)
  • 段落
  • 无序列表
  • 有序列表
  • 代码块
  • 表格
  • 粗体、斜体等文本格式

配置说明

可以在 server.py 中修改以下配置:```python
FILE_EXPIRY_HOURS = 2 # 文件有效期(小时)
TEMP_DIR = Path(tempfile.gettempdir()) / "mcp_doc_converter" # 临时文件目录


## 项目结构```
mcp_doc_converter/
├── server.py           # 主服务器文件
├── requirements.txt    # Python依赖
├── README.md          # 项目文档
├── openapi.json       # OpenAPI规范(独立文件)
└── postman_collection.json  # Postman集合

OpenAPI 规范

完整的 OpenAPI 3.0 规范可通过以下方式获取:

  1. 在线访问:http://localhost:8000/openapi.json
  2. 独立文件:查看项目根目录的 openapi.json

技术栈

  • MCP Framework: Model Context Protocol 服务器框架
  • Starlette: 轻量级 ASGI 框架
  • Uvicorn: ASGI 服务器
  • python-docx: Word 文档生成
  • markdown: Markdown 解析
  • BeautifulSoup: HTML 解析

注意事项

  1. 文件默认2小时后自动删除
  2. 临时文件存储在系统临时目录
  3. 服务重启后,之前生成的文件链接将失效
  4. 建议在生产环境中配置持久化存储和认证机制

许可证

MIT License

贡献

欢迎提交 Issue 和 Pull Request!

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Jackgic MCP 怎么安装?

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

Jackgic MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Jackgic MCP 收费吗?

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

Jackgic MCP 需要 API Key 吗?

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

Jackgic MCP 能提供哪些能力?

资料显示约 1 个工具;能力标签包括 文档转换、Python、API集成。具体工具清单以官方文档为准。

Jackgic MCP 需要什么运行环境?

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

Jackgic MCP 是本地还是远程?

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

热门专题

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

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