Content Manager MCP

🚀 コンテンツマネージャーMCPサーバー

このサーバーは、TypeScriptベースの包括的なモデルコンテキストプロトコル（MCP）サーバーで、コンテンツ管理を行います。Markdown処理、ドキュメント生成、インテリジェントなノート検索などの機能を備えています。

🚀 クイックスタート

このコンテンツマネージャーMCPサーバーは、TypeScriptを使用して開発されたMCPサーバーで、コンテンツ管理を効率的に行うことができます。以下のセクションでは、主な機能、インストール方法、使用方法などについて説明します。

✨ 主な機能

📝 Markdown処理

• 目次付きでMarkdownをHTMLにレンダリング
• 見出しを抽出し、構造化されたナビゲーションを作成
• Markdownファイルからフロントマターを解析
• HTMLサニタイズによる安全なコンテンツ処理

🔍 インテリジェント検索

• Fuse.jsを使用したノートのファジー検索
• コンテキストハイライト付きの正確なテキストマッチング
• フロントマターメタデータを使用したタグベースのフィルタリング
• 時間ベースのコンテンツ検索のための日付範囲クエリ

📊 コンテンツ分析

• ディレクトリの統計情報（ファイル数、サイズ、タイプ）を表示
• カスタマイズ可能な拡張子フィルタリングによるファイル検索
• メタデータ抽出付きのコンテンツプレビュー

📦 インストール

オプション1: NPMパッケージ（推奨）

# グローバルにインストール
npm install -g content-manager-mcp

# またはnpxで直接使用
npx -y content-manager-mcp

オプション2: ソースから

前提条件

• Node.js >= 20.0.0
• pnpm >= 9.0.0

セットアップ

# リポジトリをクローンし、依存関係をインストール
git clone <repository-url>
cd content-manager-mcp
pnpm install

# プロジェクトをビルド
pnpm build

# 開発モードで実行
pnpm dev

💻 使用例

MCPサーバーとして

サーバーは標準入出力を介して実行され、MCPプロトコルを実装しています。

NPMパッケージを使用する場合

# グローバルにインストールした場合
content-manager-mcp

# npxを使用する場合（インストール不要）
npx -y content-manager-mcp

ソースビルドを使用する場合

node dist/index.js

MCPクライアントの設定

Claude Desktop

Claude Desktopの設定に追加します。

{
  "mcpServers": {
    "content-manager": {
      "command": "npx",
      "args": ["-y", "content-manager-mcp"]
    }
  }
}

Cherry Studio

MCPサーバーを設定します。

• コマンド: npx
• 引数: ["-y", "content-manager-mcp"]

Codex

CodexのMCPサーバー設定に追加します。

{
  "mcpServers": {
    "content-manager": {
      "command": "npx",
      "args": ["-y", "content-manager-mcp"]
    }
  }
}

Claude Code

Claude Code CLIを使用してMCPサーバーを追加します。

# Claude Codeにcontent-manager-mcpサーバーを追加
claude mcp add content-manager -- npx -y content-manager-mcp

# または最初にグローバルにインストールする場合
npm install -g content-manager-mcp
claude mcp add content-manager -- content-manager-mcp

VS Code

MCP拡張機能をインストールし、設定します。

1. VS CodeマーケットプレイスからMCP拡張機能をインストールします。
2. VS Codeの設定（settings.json）に追加します。

{
  "mcp.servers": {
    "content-manager": {
      "command": "npx",
      "args": ["-y", "content-manager-mcp"]
    }
  }
}

Cursor

Cursorの設定でMCPサーバーを設定します。

1. Cursorの設定を開きます。
2. MCP設定に移動します。
3. 新しいサーバーを追加します。
   • 名前: content-manager
   • コマンド: npx
   • 引数: ["-y", "content-manager-mcp"]

またはCursorのsettings.jsonに追加します。

{
  "mcp.servers": {
    "content-manager": {
      "command": "npx",
      "args": ["-y", "content-manager-mcp"]
    }
  }
}

利用可能なツール

render_markdown

MarkdownコンテンツをHTMLに変換し、オプション機能を使用できます。

{
  content: string,           // レンダリングするMarkdownコンテンツ
  generateToc?: boolean,     // 目次を生成するかどうか（デフォルト: true）
  sanitizeHtml?: boolean,    // 出力HTMLをサニタイズするかどうか（デフォルト: true）
  enableCodeHighlight?: boolean // 構文ハイライトを有効にするかどうか（デフォルト: true）
}

search_notes

コンテンツファイルをインテリジェントに検索します。

{
  query: string,             // 検索クエリ
  directory?: string,        // 検索するディレクトリ（デフォルト: cwd）
  includeContent?: boolean,  // 結果にファイルのコンテンツを含めるかどうか（デフォルト: true）
  maxResults?: number,       // 返す最大結果数（デフォルト: 10）
  fuzzy?: boolean           // ファジー検索を使用するかどうか（デフォルト: true）
}

search_by_tags

フロントマターのタグでファイルを検索します。

{
  tags: string[],           // 検索するタグの配列
  directory?: string        // 検索するディレクトリ（デフォルト: cwd）
}

search_by_date_range

変更日によってファイルを検索します。

{
  startDate: string,        // ISO日付文字列（YYYY-MM-DD）
  endDate: string,          // ISO日付文字列（YYYY-MM-DD）
  directory?: string        // 検索するディレクトリ（デフォルト: cwd）
}

generate_table_of_contents

Markdownコンテンツから見出しを抽出し、目次として整形します。

{
  content: string           // 解析するMarkdownコンテンツ
}

extract_headings

構造化された見出し情報を取得します。

{
  content: string           // 解析するMarkdownコンテンツ
}

extract_frontmatter

MarkdownからYAMLフロントマターを解析します。

{
  content: string           // フロントマター付きのMarkdownコンテンツ
}

get_directory_stats

ディレクトリのコンテンツ統計を分析します。

{
  directory?: string        // 分析するディレクトリ（デフォルト: cwd）
}

find_content_files

特定の拡張子を持つファイルを検索します。

{
  directory?: string,           // 検索するディレクトリ（デフォルト: cwd）
  extensions?: string[]         // ファイル拡張子（デフォルト: ['.md', '.markdown', '.txt', '.mdx']）
}

read_content_file

単一のコンテンツファイルを読み取り、解析します。

{
  filePath: string             // 読み取るファイルのパス
}

🔧 技術詳細

スクリプト

• pnpm dev - ウォッチ機能付きの開発モード
• pnpm build - 本番用にビルド
• pnpm start - ビルドされたサーバーを実行
• pnpm lint - コードスタイルをチェック
• pnpm lint:fix - コードスタイルの問題を修正
• pnpm type-check - TypeScriptの型チェック
• pnpm clean - ビルドアーティファクトをクリーンする

型安全性

このプロジェクトは、Zodを使用したランタイムバリデーションとTypeScriptを使用したコンパイル時の安全性を活用しています。すべてのツール引数はランタイムで検証され、堅牢なエラーハンドリングと型安全性を保証します。

エラーハンドリング

• 包括的なエラーキャッチと報告
• 説明的なメッセージ付きのZodバリデーションエラー
• ファイルシステムのエラーハンドリング
• 不正なコンテンツに対する適切な対応

📝 使用例

フロントマターの形式

サーバーはMarkdownファイル内のYAMLフロントマターを認識します。

---
title: My Document
tags: [typescript, mcp, documentation]
author: Your Name
date: 2024-01-15
---

# Document Content

Your markdown content here...

検索例

• ファジー検索: query: "typescript mcp"（関連するコンテンツを検索）
• 正確な検索: query: "exact phrase", fuzzy: false
• タグ検索: tags: ["typescript", "documentation"]
• 日付検索: startDate: "2024-01-01", endDate: "2024-12-31"

📤 公開

このパッケージは@yugangcao/content-manager-mcpとしてNPMに公開されています。新しいバージョンを公開するには、以下の手順を実行します。

# プロジェクトをビルド
pnpm build

# バージョンを更新（patch/minor/major）
npm version patch

# NPMに公開
npm publish

詳細な公開手順については、PUBLISH_TO_NPM.mdを参照してください。

🤝 コントリビューション

1. リポジトリをフォークします。
2. 機能ブランチを作成します: git checkout -b feature-name
3. 変更を加え、テストを追加します。
4. 型が正しいことを確認します: pnpm type-check
5. プルリクエストを送信します。

📄 ライセンス

MITライセンス - 詳細についてはLICENSEファイルを参照してください。

TypeScript、Zod、最新のモダンツールを使用して、強力なコンテンツ管理を実現するために愛情を込めて開発されました。