Markdown Pipeline について
Markdown Pipelineは、Jira Cloudの課題とPC上のフォルダーをMarkdownファイルとして維持する、ローカルで動作する読み取り専用アプリです。MCPサーバーを通じてエージェントがファイルを検索・閲覧でき、元データの要約や変更は行いません。
主な機能
- 01Jira Cloudの課題とローカルフォルダーを同期
- 02指定フォルダーまたはGitHubリポジトリにMarkdownを保存
- 03ファイルの検索・閲覧・一覧表示
- 04最近の変更と同期状態を表示
- 05同期内容への読み取り専用アクセス
活用シーン
- 01AIエージェントからJira課題を検索
- 02エージェントのワークフローでプロジェクトのMarkdownを閲覧
- 03最近の変更と同期状態を確認
MCP 対応
ローカルMCPサーバーは、Claude CodeやCodexなどのクライアントに検索、閲覧、一覧、最近の変更、同期状態、同期のツールを提供します。アプリが生成したMarkdownと指定されたraw/、wiki/フォルダーを読み取り、ファイルは編集しません。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
6掲載時のツール一覧 · 今日に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| limit | integer | いいえ | |
| query | string | はい | |
| path_prefix | any | いいえ |
詳細
Markdown Pipeline
チームのツールを、AI エージェント向けに最新の状態に保たれた、整然とした Markdown ファイルとして保存します。早期アクセス:Jira Cloud と Linux 上のコンピューター内のフォルダーに対応しています。
- ローカルで動作します。 コンピューター上で実行されます。ファイルは、選択したフォルダーまたは GitHub リポジトリに保存されます。
- 読み取り専用です。 Jira やソースフォルダー内のものを変更することはありません。
- 生データ層のみです。 要約や分析は行いません。エージェント(Claude Code、Codex)がファイルを使って行います。
- あなたが見られるものだけを参照します。 ご自身のアカウントの API トークンを使って Jira を読み取るため、ファイルにはご自身のアカウントで読み取り可能な課題のみが含まれます。トークンがファイル、ログ、エージェントの回答に含まれることはありません。選択したフォルダーまたはリポジトリを開ける人は誰でもファイルを読めるため、課題を誰に見せるかを決めるときと同じように保存先を選んでください。
- オープンソースです。 Apache-2.0 ライセンスです。Jira を読み取るコードはこのリポジトリにあります。
インストール
Linux(テスト済み)。1 つのコマンドで完了します。uv(Python ツール管理ツール)がまだインストールされていない場合はインストールし、管理者権限を使わずに、アプリとともにホームフォルダー内にインストールします。
curl -fsSL https://raw.githubusercontent.com/markdown-pipeline/markdown-pipeline/main/install.sh | sh
GitHub Releases から最新リリースをインストールします。GitHub アカウント、トークン、サインインは不要です。その後、mdpipeline と入力すると、ブラウザーでアプリが開きます。シェルに mdpipeline: command not found と表示された場合は、新しいターミナルを開く(または uv tool update-shell を実行する)と、再度試せます。
同じコマンドをいつでも再実行して最新リリースに更新できます。設定とパイプラインはそのまま保持されます。
対応プラットフォーム: Linux(テスト済み)。macOS は未テストです。Windows では WSL 2(Ubuntu)を使い、その中でコマンドを実行してください。サーバーまたは WSL 2 では、loginctl enable-linger $USER を一度実行しない限り、ログアウトするとバックグラウンド同期が停止します。再起動後は、ログインするか、任意の mdpipeline コマンドを実行すると、同期が再開します。
エージェントから使う(MCP)
アプリにはローカル MCP サーバーが含まれているため、Claude Code または Codex からファイルを検索して読み取れます。
mdpipeline connect --agent claude # or: --agent codex
セットアップに必要な正確なコマンド(Claude Code)または設定ブロック(Codex)が表示されます。必要なときにエージェント自身がサーバーを起動するため、バックグラウンドで別のプロセスが実行されることはありません。ツール: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 をご覧ください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。