Content Manager MCP

🚀 內容管理器MCP服務器

這是一個基於TypeScript的綜合模型上下文協議（MCP）服務器，用於內容管理，支持Markdown處理、文檔生成和智能筆記搜索等功能。

🚀 快速開始

本服務器通過標準輸入輸出運行，並實現了MCP協議。以下是不同使用方式的啟動方法：

使用NPM包

# 若已全局安裝
content-manager-mcp

# 使用npx（無需安裝）
npx -y content-manager-mcp

使用源碼構建

node dist/index.js

✨ 主要特性

📝 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客戶端配置

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服務器：

# 將content-manager-mcp服務器添加到Claude Code
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,        // 搜索目錄（默認：當前工作目錄）
  includeContent?: boolean,  // 在結果中包含文件內容（默認：true）
  maxResults?: number,       // 返回的最大結果數（默認：10）
  fuzzy?: boolean           // 使用模糊搜索（默認：true）
}

search_by_tags

根據前置元數據標籤查找文件：

{
  tags: string[],           // 要搜索的標籤數組
  directory?: string        // 搜索目錄（默認：當前工作目錄）
}

search_by_date_range

根據修改日期查找文件：

{
  startDate: string,        // ISO日期字符串（YYYY-MM-DD）
  endDate: string,          // ISO日期字符串（YYYY-MM-DD）
  directory?: string        // 搜索目錄（默認：當前工作目錄）
}

generate_table_of_contents

提取並將標題格式化為目錄：

{
  content: string           // 要分析的Markdown內容
}

extract_headings

獲取結構化的標題信息：

{
  content: string           // 要分析的Markdown內容
}

extract_frontmatter

從Markdown中解析YAML前置元數據：

{
  content: string           // 包含前置元數據的Markdown內容
}

get_directory_stats

分析目錄內容統計信息：

{
  directory?: string        // 要分析的目錄（默認：當前工作目錄）
}

find_content_files

查找具有特定擴展名的文件：

{
  directory?: string,           // 搜索目錄（默認：當前工作目錄）
  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"

📤 發佈

本包已發佈到NPM，名稱為 @yugangcao/content-manager-mcp。要發佈新版本，請執行以下操作：

# 構建項目
pnpm build

# 更新版本（補丁/小版本/大版本）
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和最新的現代工具精心打造，為您提供強大的內容管理功能。