解析 Media Kit pdf 文件

Media Kit MCP Server

经 MCP Review 认证

概述

Media Kit MCP Server 是一项用于解析和分析 Media Kit PDF 文件的服务，Media Kit PDF 文件常用于广告和营销行业。它会从 PDF 文件中提取关键信息，将其转换为 Markdown，并利用 AI（DeepSeek API）全面分析内容，包括受众人口统计特征、定价和营销洞察。该服务可作为插件集成到 MCP（Model Context Protocol）宿主中，同时支持 stdio 和 HTTP API 模式。

---

功能

• PDF 转 Markdown：自动提取本地 PDF 文件并将其转换为 Markdown 文本。
• AI 驱动的内容分析：使用 DeepSeek API 分析 Media Kit 内容，提供结构化洞察（受众、套餐、覆盖范围等）。
• MCP 协议支持：实现 MCP 服务协议，便于通过 stdio 集成到 MCP 宿主。
• 可选的 RESTful API：提供 HTTP API，供前端或第三方集成使用。
• TypeScript 和类型安全：使用 TypeScript 编写，并提供清晰的类型定义，便于维护。
• 测试：包含集成测试和 API 测试，确保可靠性。
• 简易网页界面：（可选）提供一个基础 HTML 页面，用于本地测试 HTTP API。

---

目录结构

media_kit_mcp_server/
├── src/
│   ├── index.ts              # MCP server entry point
│   ├── server.ts             # MCP server logic and tool registration
│   ├── nodeServer.ts         # Optional HTTP API server
│   ├── mcpClient.ts          # MCP client for local API calls
│   ├── helper/
│   │   ├── markdownify.ts    # PDF-to-Markdown utility
│   │   └── deepseek.ts       # DeepSeek AI analysis utility
│   ├── type/
│   │   ├── common.ts         # Common type definitions
│   │   └── mediaKit.ts       # Media Kit structure types
│   ├── test/
│   │   ├── comprehensive.test.ts # Integration test
│   │   └── deepseek.test.ts      # DeepSeek API test
│   └── index.html            # Simple web UI for HTTP API
├── package.json
├── tsconfig.json
└── README.md

---

入门

1. 安装依赖

npm install

2. 构建项目

npm run build

3. 作为 MCP 服务运行（推荐）

在 MCP HOST 配置中，将此项目集成为 MCP 插件：

{
  "mcpServers": {
    "media-kit-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"],
      "env": {
        "DEEP_SEEK_API_KEY": "YOUR_DEEP_SEEK_API_KEY"
      },
      "transport": "stdio",
      "enabled": true,
      "description": "Parse and analyze Media Kit PDF files for advertising and marketing use cases"
    }
  }
}

4. 作为 HTTP API 运行（可选）

若要使用 HTTP API（供前端或第三方集成使用）：

npm run build
node dist/nodeServer.js

服务默认会监听端口 3000。你可以使用附带的 src/index.html 页面或通过 API 调用进行测试。

---

MCP 工具

parse-pdf-to-markdown

• 描述：将本地 PDF 文件（file://）转换为 Markdown 文本。
• 参数模式：

  {
    "pdfUrl": "file:///absolute/path/to/file.pdf"
  }
  

• 返回模式：

  {
    "content": [
      {
        "type": "text",
        "text": "Extracted markdown content..."
      }
    ],
    "error": "Error message if any error occurred."
  }
  

analyze-media-kit

• 描述：分析 Media Kit Markdown 内容并返回结构化洞察（受众、定价等）。
• 参数模式：

  {
    "markdown": "# Media Kit\n..."
  }
  

• 返回模式：

  {
    "content": [
      {
        "type": "text",
        "text": "{ \"basicInfo\": { ... }, \"analysis\": { ... } }"
      }
    ],
    "error": "Error message if any error occurred."
  }
  

---

HTTP API 参考

• POST /analyze
  • 请求体：{ pdfUrl: "file:///absolute/path/to/file.pdf" }
  • 响应：JSON 分析结果

---

依赖项

• Node.js 18+
• TypeScript
• @modelcontextprotocol/sdk
• DeepSeek API（需要 DEEP_SEEK_API_KEY 环境变量）
• markitdown（用于 PDF 转 Markdown，需要本地 Python 虚拟环境和 markitdown 工具）

---

开发与测试

运行测试

# Integration test
ts-node src/test/comprehensive.test.ts

# DeepSeek API test
ts-node src/test/deepseek.test.ts

代码结构

• src/helper/markdownify.ts：调用本地 markitdown 工具，将 PDF 转换为 Markdown。
• src/helper/deepseek.ts：封装 DeepSeek API，用于内容分析。
• src/server.ts：注册 MCP 工具并处理请求。
• src/nodeServer.ts：提供 HTTP API，以便外部集成。
• src/index.html：用于本地测试 HTTP API 的简易网页界面。

---

常见问题

• 找不到 markitdown？

  • 请确保在项目根目录的上级目录中，已于 .venv/bin/markitdown 安装带有 markitdown 的 Python 虚拟环境。

• 缺少 DeepSeek API 密钥？

  • 在运行服务前设置 DEEP_SEEK_API_KEY 环境变量。

---

许可证

本项目采用 ISC 许可证。

---

贡献

欢迎贡献、反馈问题和提出功能请求！请提交 issue 或 pull request。