Duyet MCP Server

🚀 duyet-mcp-server

這是一個實驗性的 MCP (模型上下文協議) 服務器，可幫助AI助手連接並獲取有關duyet的信息。該服務器主要提供 https://duyet.net 上的信息，讓你的AI助手能夠直接訪問這些內容。

🚀 快速開始

使用方法：在你的AI助手中更新MCP服務器配置：

{
  "mcpServers": {
    "duyet-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.duyet.net/sse"
      ]
    }
  }
}

如果你使用的是Claude Code：

claude mcp add --transport http duyet https://mcp.duyet.net/mcp

端點：

• https://mcp.duyet.net/sse
• https://mcp.duyet.net/mcp

✨ 主要特性

• 這是一個研究、演示和實驗項目，旨在探索MCP的能力。該項目是構建遠程MCP服務器的學習實踐，大部分代碼由大語言模型生成。
• 目的是讓AI助手能夠訪問和檢索有關duyet的工作、項目和內容的信息，而無需手動瀏覽網頁。

📦 安裝指南

部署到Cloudflare Workers

這將把你的MCP服務器部署到類似如下的URL：duyet-mcp-server.<your-account>.workers.dev/sse

或者，你可以通過命令行克隆並部署：

git clone https://github.com/duyet/duyet-mcp-server
cd duyet-mcp-server
npm install
npm run deploy

💻 使用示例

基礎用法

{
  "mcpServers": {
    "duyet-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.duyet.net/sse"
      ]
    }
  }
}

高級用法

如果你使用Claude Code，可以通過以下命令添加MCP服務器：

claude mcp add --transport http duyet https://mcp.duyet.net/mcp

📚 詳細文檔

自定義MCP服務器

要向MCP服務器添加你自己的工具，可以在 src/index.ts 的 init() 方法中使用 this.server.tool(...) 來定義每個工具。

連接到Cloudflare AI Playground

你可以使用Cloudflare AI Playground測試你的MCP服務器：

1. 訪問 https://playground.ai.cloudflare.com/
2. 輸入你部署的MCP服務器URL (duyet-mcp-server.<your-account>.workers.dev/sse 或 duyet-mcp-server.<your-account>.workers.dev/mcp)
3. 現在你可以直接在Playground中使用duyet信息工具！

從Claude Desktop連接到MCP服務器

你可以使用 mcp-remote代理 從Claude Desktop連接到你的遠程MCP服務器。 要從Claude Desktop連接，請遵循 Anthropic的快速入門指南，然後轉到設置 > 開發者 > 編輯配置。 使用以下配置進行更新：

{
  "mcpServers": {
    "duyet-info": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://duyet-mcp-server.<your-account>.workers.dev/sse"
      ]
    }
  }
}

你應該會看到duyet-mcp信息工具可用。

可用資源和工具

這個MCP服務器提供了資源（通過URI進行只讀數據訪問）和工具（帶有參數的交互式函數）。Claude Chat可以自動發現資源，以實現自然的對話流程，而工具則用於需要用戶輸入的操作。

資源

資源通過基於URI的請求提供對信息的只讀訪問。Claude Chat可以自動發現這些資源。

• 核心信息資源
  • duyet://about - 關於Duyet的基本信息，包括動態計算的工作經驗年限
  • duyet://cv/{format} - 簡歷，帶有格式參數：
    • duyet://cv/summary - 簡歷簡要概述
    • duyet://cv/detailed - 簡歷詳細信息
    • duyet://cv/json - 結構化的簡歷數據（如果可用）
• 內容資源
  • duyet://blog/posts/{limit} - Duyet技術博客的最新文章
    • duyet://blog/posts/1 - 最新文章
    • duyet://blog/posts/5 - 最新5篇文章（限制：1 - 10）
  • duyet://github-activity - 最近的GitHub貢獻和活動

工具

工具提供帶有輸入參數和副作用的交互式功能。

• send_message - 向Duyet發送消息，用於合作、工作機會、諮詢或一般詢問。消息將保存一個參考ID以便跟進
• get_cv - 以不同格式（摘要、詳細或JSON格式）檢索Duyet的簡歷
• get_github_activity - 檢索Duyet最近的GitHub活動，包括提交、問題、拉取請求、版本發佈和其他公共事件。最多可查看20條最近的活動，並可選擇查看詳細信息
• hire_me - 獲取有關聘請Duyet擔任各種職位（全職、合同工、顧問或兼職）的信息。包括專業技能、經驗和後續步驟
• say_hi - 向Duyet發送友好問候，並可選擇附帶個人消息。獲取聯繫信息和連接鏈接
• contact_analytics - 生成關於聯繫人提交的分析報告，包括彙總統計、目的分類、每日趨勢和最近的活動模式

Claude Chat示例

以下是使用此MCP服務器的自然對話流程示例：

瞭解Duyet

用戶：Duyet是誰，他是做什麼的？

Claude：[自動訪問duyet://about資源]
Duyet是一名有8年經驗的數據工程師。他對數據工程概念、最佳實踐以及最新的數據和雲技術充滿信心。你可以訪問他的博客 https://blog.duyet.net，查看他的簡歷 https://duyet.net/cv，以及他的項目 https://github.com/duyet。

用戶：他最近在寫什麼？

Claude：[自動訪問duyet://blog/posts/3資源]
他最近的博客文章涵蓋了數據工程、雲技術和分佈式系統等主題。你想了解某篇特定文章的更多細節嗎？

用戶：他目前正在從事什麼工作？

Claude：[自動訪問duyet://github-activity資源]
根據他最近的GitHub活動，Duyet一直在從事MCP服務器實現、數據管道項目，併為數據工程的開源工具做出貢獻。

招聘與合作

用戶：我正在尋找一名數據工程師。你能幫我聯繫Duyet嗎？

Claude：我可以使用send_message工具幫你向Duyet發送消息。這是什麼類型的機會？

用戶：這是我們初創公司的一個全職職位，需要使用Kafka和Spark。

Claude：[使用send_message工具]
你想在給Duyet的消息中說些什麼？我會確保說明這是一個使用Kafka和Spark技術的全職職位。

用戶：嗨，Duyet，我們是一家A輪融資的初創公司，正在構建實時數據平臺。我們很想討論一個高級數據工程師的職位，涉及Kafka、Spark和雲基礎設施。這是一個支持遠程工作的職位，有具有競爭力的股權。

Claude：[執行send_message工具併發送消息]
你的消息已成功發送！這是你的參考ID：abc-123-def，以便跟進。你可以直接通過 me@duyet.net 聯繫Duyet，也可以在LinkedIn上找到他：https://linkedin.com/in/duyet，或者在GitHub上查看他的項目：https://github.com/duyet。

技術研究

用戶：在面試之前，我想了解Duyet的技術背景。

Claude：[自動訪問duyet://cv/detailed資源]
根據Duyet的詳細簡歷，他有8年的數據工程經驗，擅長Apache Spark、Kafka、雲平臺和分佈式系統。他的經驗包括構建可擴展的數據管道和使用現代數據棧技術。

用戶：你能給我展示一些他最近的技術工作嗎？

Claude：[自動訪問duyet://github-activity資源]
他最近的GitHub活動顯示了他對數據工程項目、MCP服務器實現和開源工具的貢獻。他一直在積極從事分佈式系統和雲原生數據解決方案的工作。

用戶：他寫的內容涉及哪些類型？

Claude：[自動訪問duyet://blog/posts/5資源]
他的技術博客涵蓋了諸如構建可擴展數據管道、現代數據工程最佳實踐、雲技術和分佈式系統架構等主題。

自然發現模式

這個MCP服務器設計的主要優勢在於，Claude Chat可以通過資源自然地發現和引用信息，使對話更加流暢：

1. 信息問題 → 自動資源訪問
   • "Duyet是誰？" → duyet://about
   • "他有什麼經驗？" → duyet://cv/detailed
   • "他在寫什麼？" → duyet://blog/posts/3
   • "他在做什麼工作？" → duyet://github-activity
2. 行動請求 → 交互式工具
   • "我想聯繫他" → send_message 工具
   • "你能給他發送問候嗎？" → say_hi 工具
   • "獲取他的簡歷" → get_cv 工具
3. 逐步披露
   • 從一般性問題開始
   • 深入到具體領域
   • 準備好後採取行動

🔧 技術細節

• 框架：運行在Cloudflare Workers上的Hono.js
• 數據庫：使用Drizzle ORM的Cloudflare D1
• 測試：使用Jest進行全面的測試覆蓋
• 代碼檢查：使用Biome進行代碼質量檢查
• 類型安全：使用嚴格配置的TypeScript

📄 許可證

本項目採用MIT許可證，詳情請參閱LICENSE文件。