MarkScribe

Model Context Protocolのための、規約重視のMarkdown MCPサーバーです。MarkScribeを使用すると、AIエージェントはMarkdownファイルの読み取り、書き込み、検索、検証を行うことができ、ユーザー定義のYAMLスキーマを通じて規約を強制できます。Obsidianボルト、Foamワークスペース、デジタルガーデン、ドキュメントリポジトリなど、あらゆるMarkdownディレクトリで動作します。

特徴

• アトミックなファイル操作によるノートの読み取り、書き込み、移動、削除

• コンテンツおよびフロントマターを対象とした全文検索（BM25ランキング）

• ウィキリンク対応：バックリンク、リンク切れ検出、孤立ノートの特定、未リンクの言及の発見

• YAMLフロントマターの解析、検証、一括更新

• タグ管理（フロントマターおよびインライン）

• スキーマによる規約の強制：ノートスキーマによるフロントマター/コンテンツの検証、フォルダスキーマによる構造ルールの強制

• 規約の継承：_conventions.mdファイルにより、ディレクトリのサブツリーにスキーマを適用可能

• パスのセキュリティ：.obsidian/、.git/、node_modules/は常にブロック

Related MCP server: mcp-obsidian

インストール

npm install -g markscribe

使用方法

MCPサーバーとして

{
 "mcpServers": {
 "markscribe": {
 "command": "markscribe",
 "args": ["--root", "/path/to/your/notes"]
 }
 }
}

CLIフラグ

ディレクトリごとの設定

ルートディレクトリに .markscribe/config.yaml を配置します：

paths:
 blocked:
 - private/
 - drafts/
 allowed_extensions:
 - .md
 - .markdown
 - .txt
search:
 max_results: 50
 excerpt_chars: 40

スキーマ

スキーマはノートやフォルダの規約を定義します。スキーマディレクトリ（デフォルトは ~/.markscribe/schemas/）に配置してください。

ノートスキーマ — フロントマターのフィールドとコンテンツのルールを検証します：

name: blog-post
description: Blog post with required metadata
type: note
frontmatter:
 fields:
 title:
 type: string
 required: true
 tags:
 type: list
 required: true
content:
 rules:
 - name: has-outgoing-link
 check: hasPattern
 pattern: "\\[\\[.+?\\]\\]"

フォルダスキーマ — ディレクトリの構造ルールを強制します：

name: project-folder
description: Project folder with hub note
type: folder
noteSchemas:
 default: blog-post
 hub: project-hub
classification:
 supplemental: [assets, templates]
 skip: [archive]
hub:
 detection:
 - pattern: "_{{folderName}}"
 required: true

ノートはフロントマターの note_schema: <name> を通じて、または規約の継承（_conventions.mdファイル）を通じて自動的にスキーマを適用します。

ツール

対応ビューア

MarkScribeは、Markdownファイルを読み取れるあらゆるツールと連携します：

• Obsidian — グラフビューとコミュニティプラグインを備えたPKMアプリ

• Foam — リンクされたノートのためのVS Code拡張機能

• Logseq — 双方向リンクを備えたアウトライナー

• その他のテキストエディタや静的サイトジェネレーター

謝辞

Claude Code を使用して構築されました。

ライセンス

MIT

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• create_noteA
• delete_noteA
• find_bidirectional_mentionsA
• find_broken_linksA
• find_orphansA
• find_unlinked_mentionsA
• get_backlinksA
• get_frontmatterA