MCP Tabnews

🚀 MCP 與 TabNews 集成

本項目實現了 TabNews 的 Model Context Protocol (MCP) 集成，可讓你方便地與 TabNews 進行交互。此 MCP 服務器還能直接在 Smithery 上使用，無需額外配置。

✨ 主要特性

• 使用 Model Context Protocol (MCP) 構建。
• 型安全，使用 TypeScript 和 Zod 模式驗證。
• Node.js 中原生 TypeScript 支持，無需轉譯。
• 採用標準 I/O 傳輸協議。
• 包含詳細文檔和示例代碼。

📦 安裝指南

手動安裝

1. 確保使用 Node.js v23+ 版本：

node -v
#v23.11.0

2. 克隆此倉庫：

git clone https://github.com/renant/mcp-tabnews.git
cd mcp-tabnews

3. 恢復依賴項：

npm ci

💻 使用示例

檢查 MCP 服務器功能

使用 Smithery 可以檢查此 MCP 服務器的功能：

npx -y @smithery/cli@latest inspect @renant/mcp-tabnews

這將顯示所有可用工具、它們的參數以及如何使用。

📚 詳細文檔

可用工具

• checkStatusTool：檢查 TabNews API 狀態。
• getContentsTool：從 TabNews 獲取內容。
• getContentsByUserTool：按用戶從 TabNews 獲取內容。
• getContentTool：通過用戶和文章 slug 從 TabNews 獲取帶有正文的內容。
• getContentChildrenTool：獲取 TabNews 某篇文章的評論。
• getAnalyticsUserCreatedTool：獲取某個用戶創建內容的分析數據。
• getAnalyticsRootContentPublishedTool：獲取已發佈的根內容的分析數據。
• getAnalyticsChildContentPublishedTool：獲取子內容發佈的分析數據。
• getRssFeedTool：獲取 TabNews 的 RSS 源。

與 AI 工具集成

Cursor 設置

1. 打開 Cursor 設置。
2. 導航到 MCP 部分。
3. 點擊“添加新的 MCP 服務器”。
4. 配置服務器：

名稱 = mcp-tabnews
類型 = 命令
命令 = node 絕對路徑項目目錄 /src/index.ts

或者從 Smithery 執行：

名稱 = mcp-tabnews
類型 = 命令
命令 = npm exec -- @smithery/cli@latest run @renant/mcp-tabnews

或者直接在 Cursor 的全局 MCP 文件 ~/.cursor/mcp.json 中添加以下內容：

{
  "mcpServers": {
    "mcp-tabnews": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
    }
  }
}

或者從 Smithery 執行：

{
  "mcpServers": {
    "mcp-tabnews": {
      "command": "npm",
      "args": [
        "exec",
        "--",
        "@smithery/cli@latest",
        "run",
        "@renant/mcp-tabnews"
      ]
    }
  }
}

5. 確保 Cursor 聊天處於“代理”模式，位於左下角下拉菜單中選擇“代理”。
6. 前往聊天並詢問任何關於 TabNews 的問題。

Claude Desktop 設置

通過 Smithery 安裝

要通過 Smithery 自動安裝 TabNews 用於 Claude Desktop：

npx -y @smithery/cli install @renant/mcp-tabnews --client claude

🔧 技術細節

• MCP 協議：實現了通用的模型上下文協議，支持分佈式 AI 系統。
• 可擴展性：設計上支持大規模擴展，適用於高併發場景。
• 模塊化架構：各個功能模塊獨立開發，便於維護和升級。

🤝 貢獻指南

1. 請在提交代碼前閱讀並遵循我們的 貢獻規範。
2. 提交問題到 GitHub Issues。
3. 歡迎 fork 倉庫並在自己的分支上進行開發。

👥 貢獻者

• [@renant] - 項目發起人和主要開發者。
• 其他貢獻者名單將在未來的更新中添加。

📄 許可證

[項目許可證信息]