mcpField
M
Markdown Pipeline

Markdown Pipeline

本地服务
markdownpipeline.com记忆与知识0今天更新
代码仓库访问官网

关于 Markdown Pipeline

Markdown Pipeline 是一款本地只读应用，可将 Jira Cloud 问题和电脑文件夹持续整理为 Markdown 文件，供团队的 AI Agent 使用。其 MCP 服务允许 Agent 搜索和读取文件，不会总结或修改源数据。

主要功能

  1. 01同步 Jira Cloud 问题和本地文件夹
  2. 02将 Markdown 写入指定文件夹或 GitHub 仓库
  3. 03搜索、读取和列出文件
  4. 04查看近期变更和同步状态
  5. 05只读访问同步内容

适用场景

  1. 01通过 AI Agent 搜索 Jira 问题
  2. 02在 Agent 工作流中读取项目 Markdown 文件
  3. 03查看近期变更和同步状态

MCP 相关

本地 MCP 服务向 Claude Code、Codex 等客户端提供搜索、读取、列出、近期变更、同步状态和同步工具。它读取应用生成的 Markdown 文件及指定的 raw/ 和 wiki/ 文件夹；工具不会编辑文件。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "markdown-pipeline-mdpipeline": {
      "command": "uvx",
      "args": [
        "mdpipeline"
      ]
    }
  }
}
启动命令uvx mdpipeline

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypimdpipeline0.1.23

工具

6

收录的工具列表 · 更新于 今天

参数类型必填说明
limitinteger否
querystring是
path_prefixany否

详细介绍

Markdown Pipeline

将团队的工具整理为简洁的 Markdown 文件，并持续为你的 AI Agent 更新。抢先体验：Jira Cloud 和 Linux 上的本地文件夹。

  • 本地运行。 它在你的电脑上运行。文件会保存到你选择的文件夹或 GitHub 仓库。
  • 我们只读取。 我们绝不会更改 Jira 或你的源文件夹中的任何内容。
  • 仅提供原始层。 它不会总结或分析任何内容。你的 Agent（Claude Code、Codex）会根据这些文件完成这些工作。
  • 它看到的内容与你相同。 它使用你自己账户的 API 令牌读取 Jira，因此文件中只包含你的账户有权读取的问题。令牌绝不会出现在文件、日志或 Agent 的回答中。任何能够打开你所选文件夹或仓库的人都能读取文件，因此请选择一个文件夹或仓库，就像选择谁能看到这些问题一样。
  • 开源。 Apache-2.0。读取 Jira 的代码就在此仓库中。

安装

Linux（已测试）。只需一条命令。如果你尚未安装 uv（Python 工具管理器），该命令会安装它，然后将应用安装到你的主目录下，全程无需管理员权限：

curl -fsSL https://raw.githubusercontent.com/markdown-pipeline/markdown-pipeline/main/install.sh | sh

它会从 GitHub Releases 安装最新版本。无需 GitHub 账户、令牌或登录。然后输入 mdpipeline：浏览器会打开应用。如果你的 shell 提示 mdpipeline: command not found，请打开新的终端（或运行 uv tool update-shell），然后重试。 随时可以再次运行同一条命令，更新到最新版本；你的设置和流水线会保留。

平台： Linux（已测试）。macOS 尚未测试。Windows 用户请使用 WSL 2（Ubuntu），并在其中运行该命令。在服务器或 WSL 2 上，除非你运行一次 loginctl enable-linger $USER，否则退出登录后后台同步会停止；重启后，登录或运行任意 mdpipeline 命令即可重新启动它。

在 Agent 中使用（MCP）

应用内置本地 MCP 服务，因此 Claude Code 或 Codex 可以搜索和读取文件。

mdpipeline connect --agent claude   # or: --agent codex

它会为你的配置输出准确的命令（Claude Code）或配置代码块（Codex）。Agent 需要时会自行启动服务；没有其他程序会在后台运行。工具包括：search、read、list、recent_changes（“昨天以来有哪些变化？”）、sync_status 和 sync。没有任何工具会写入或编辑你的文件。服务只会在你的电脑上读取应用写入的 Markdown 文件（以及你的 raw/ 和 wiki/ 文件夹）。

我们会发送什么

仅在你选择分享时发送使用数据，以及你按下“发送”时在反馈或来源请求中输入的文字。 完整列表以通俗易懂的文字列出：what-we-send。随时可关闭：mdpipeline usage off。

反馈和问题

在此仓库中提交 issue：Issues。请告诉我们你尝试了什么、预期结果是什么，以及实际发生了什么。

卸载

mdpipeline uninstall 会关闭后台同步，并打印用于移除程序的一条命令。它写入的 Markdown 文件会保留在原处。

完整参考（命令、设置、安全规则）：docs/reference.md。

许可证

Apache-2.0。请参阅 LICENSE。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。