Weiwanmcpserver

🚀 Show Time：AI極客馬拉松項目 - 超能聊天 + 自定義MCP服務器

本項目是在AI極客馬拉松競賽中誕生的成果，結合了超能聊天（開源聊天客戶端）與自定義MCP服務器。通過聊天交互調用MCP工具，實現網絡資訊檢索、筆記下載、管理與複寫等功能，為用戶提供便捷的知識管理體驗。

🚀 快速開始

在本次AI極客馬拉松競賽裡，項目實現了一個基於超能聊天和自定義MCP服務器的程序。藉助聊天交互調用MCP工具，達成如下核心功能：

1. 網絡資訊檢索：能在指定站點（像知乎）檢索與關鍵詞相關的資料，以鏈接 + 摘要的形式返回。
2. 筆記下載：可把檢索到的鏈接內容下載成Markdown筆記，保存到本地筆記倉庫。
3. 筆記管理：能對筆記開展查看、總結、刪除等操作（基於Obsidian的開源實現）。
4. 筆記複寫：可對下載的筆記進行內容複寫或整理。

✨ 主要特性

1. 無縫集成：藉助超能聊天實現自然語言交互，降低用戶學習成本。
2. 高效檢索：支持指定站點檢索，能快速獲取目標資訊。
3. 本地化管理：將網絡內容保存為Markdown筆記，便於後續整理和複用。
4. 靈活性：支持筆記複寫和Obsidian集成，滿足個性化需求。

📦 安裝指南

文檔未提及安裝步驟，暫不展示。

💻 使用示例

基礎用法

from mcp.server.fastmcp import FastMCP
from datetime import datetime
import os
import requests
import re

mcp = FastMCP("WeiWanMcp", instructions="""
    限制:
        1.調用search_news查詢資訊後,不要對內容進行總結,直接進行輸出.
""")

nodePath = os.getenv("NOTES_PATH", "E:\MyDocuments\MyNotes\Clipper")

@mcp.tool()
def search_news(query: str, website: str):
    """檢索網絡資訊"""
    url = 'https://s.jina.ai/?q=' + query + '&num=20'
    headers = {
        'Authorization': 'Bearer YOUR_API_KEY',
        'X-Respond-With': 'no-content',
    }
    if website:
        if validate_domain(website):
            headers['X-Site'] = website
    response = requests.get(url, headers=headers)
    return response.text

@mcp.tool()
def download_note(webLink: str, nodeTitle: str):
    """下載網頁內容為筆記"""
    headers = {"Authorization": "Bearer YOUR_API_KEY"}
    response = requests.get("https://r.jina.ai/" + webLink, headers=headers)
    with open(nodePath + "\\" + nodeTitle + ".md", "w", encoding='utf-8') as file:
        file.write(response.text)
    return "筆記已保存至: " + nodePath + "\\" + nodeTitle + ".md"

@mcp.tool()
def overwrite_note(webLink: str, nodeTitle: str):
    """複寫或整理筆記內容"""
    headers = {"Authorization": "Bearer YOUR_API_KEY"}
    response = requests.get("https://r.jina.ai/" + webLink, headers=headers)
    with open(nodePath + "\\" + nodeTitle + ".md", "w", encoding='utf-8') as file:
        file.write(response.text)
    return "筆記已複寫至: " + nodePath + "\\" + nodeTitle + ".md"

高級用法

文檔未提及高級用法相關代碼，暫不展示。

📚 詳細文檔

🔧 技術細節

1. 核心組件

• 超能聊天：作為用戶交互的前端，支持聊天式調用MCP工具。
• 自定義MCP服務器：基於Python實現，提供以下工具：
  • search_news: 檢索網絡資訊。
  • download_note: 下載網頁內容為Markdown筆記。
  • overwrite_note: 複寫或整理筆記內容。
  • 其他輔助工具（如獲取當前時間、日期等）。

2. 代碼亮點

服務器端代碼實現了網絡資訊的檢索、下載和複寫功能，支持指定站點（如知乎）的精準搜索。使用requests庫進行HTTP請求處理，確保數據獲取高效穩定。筆記內容存儲在本地Markdown文件中，便於後續編輯和管理。

🌟 項目亮點

• 無縫集成：通過超能聊天實現自然語言交互，降低用戶學習成本。
• 高效檢索：支持指定站點檢索，快速獲取目標資訊。
• 本地化管理：將網絡內容保存為Markdown筆記，方便後續整理和複用。
• 靈活性：支持筆記複寫和Obsidian集成，滿足個性化需求。

🚀 未來展望

• 擴展工具集：增加更多MCP工具（如翻譯、摘要生成等）。
• 多平臺支持：適配更多筆記軟件（如Notion、Logseq）。
• 性能優化：提升檢索和下載速度，優化用戶體驗。

📷 功能截圖

📄 結語

本次項目結合超能聊天和自定義MCP服務器，實現了從資訊檢索到筆記管理的全流程自動化。未來會進一步優化功能，為用戶提供更強大的知識管理工具！