文档摘要与编辑工具

基于Python的MCP服务器,通过命令行界面实现文档管理、摘要生成和编辑功能。

  • by mojarrad353
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 mojarrad353/mcp-doc-summarize-edit

使用说明

📄 文档摘要和编辑MCP


这 文档摘要和编辑MCP 是一个 基于Python的MCP服务器 它使用户能够通过 命令行界面(CLI).

特性

  • 文档管理:读取、列出和编辑文档。
  • MCP 服务器:FastMCP实施。
  • OpenAI集成:使用OpenAI模型对文档进行总结和改写。
  • CLI聊天:交互式命令行界面。
  • Docker支持:容器化,便于部署。

项目结构

mcp_doc_summarize_edit/
├── src/
│   └── mcp_document_summary/
│       ├── client/         # Client implementation
│       ├── core/           # Core logic (Chat, OpenAI, CLI)
│       ├── server/         # MCP Server implementation
│       ├── config.py       # Configuration settings
│       ├── logger.py       # Logging
│       └── main.py         # Entry point
├── tests/                  # Unit tests
├── Dockerfile
├── docker-compose.yml
├── docker-compose.yml
├── pyproject.toml
└── README.md

先决条件

  • Python 3.10+
  • uv (必填)
  • OpenAI API密钥

设置

  1. 克隆仓库

  2. 配置环境 复制 .env.example 到 .env 并填写您的详细信息:

    cp .env.example .env
    

    编辑 .env 与你的 OPENAI_API_KEY.

  3. 安装依赖项 使用 uv:

    uv sync
    

运行应用程序

本地开发

  1. 启动MCP服务器 (1号航站楼)

    uv run python -m mcp_document_summary.server.server
    

    服务器将于启动 http://127.0.0.1:8000.

  2. 启动客户端 (2号航站楼)

    uv run python -m mcp_document_summary.main --url http://127.0.0.1:8000/sse
    

码头工人

使用Docker Compose运行:

docker-compose up --build

测试

运行单元测试:

uv run pytest

配置

设置通过以下方式管理 .env 文件和 src/mcp_document_summary/config.py.

  • OPENAI_API_KEY:您的OpenAI API密钥。
  • OPENAI_MODEL_NAME:要使用的模型(默认值:gpt-4o)。
  • LOG_LEVEL:日志记录级别(默认值:INFO)。

许可证

[许可证]