Weiwanmcpserver

🚀 Show Time：AI極客マラソンプロジェクト - スーパーチャット + カスタムMCPサーバー

このプロジェクトは、スーパーチャット（オープンソースのチャットクライアント）とカスタムMCPサーバーを組み合わせたプログラムです。チャットを通じてMCPツールを呼び出し、以下の機能を実現します。

1. ネットワーク情報検索：指定したサイト（例：知乎）でキーワードに関連する資料を検索し、リンクと要約を返します。
2. ノートダウンロード：検索したリンクの内容をMarkdownノートとしてダウンロードし、ローカルのノート倉庫に保存します。
3. ノート管理：ノートの閲覧、要約、削除などの操作を行います（Obsidianのオープンソース実装に基づく）。
4. ノート書き直し：ダウンロードしたノートの内容を書き直したり整理したりします。

🚀 クイックスタート

このプロジェクトは、AI極客マラソン競技で開発されたもので、スーパーチャットとカスタムMCPサーバーを利用して、ネットワーク情報の検索からノート管理までの一連の流れを自動化します。

✨ 主な機能

1. シームレスな統合：スーパーチャットによる自然言語対話を実現し、ユーザーの学習コストを削減します。
2. 効率的な検索：指定したサイトでの検索をサポートし、目的の情報を迅速に取得します。
3. ローカル管理：ネットワーク上の内容をMarkdownノートとして保存し、後の整理や再利用を容易にします。
4. 柔軟性：ノートの書き直しとObsidianとの統合をサポートし、個別のニーズに対応します。

📦 インストール

このREADMEには具体的なインストール手順が記載されていないため、このセクションをスキップします。

💻 使用例

基本的な使用法

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"

高度な使用法

このREADMEに高度な使用法のコード例が記載されていないため、このサブセクションを省略します。

📚 ドキュメント

1. 核心コンポーネント

• スーパーチャット：ユーザーとの対話を行うフロントエンドで、チャット形式でMCPツールを呼び出すことができます。
• カスタムMCPサーバー：Pythonで実装され、以下のツールを提供します。
  • search_news: ネットワーク情報を検索します。
  • download_note: ウェブページの内容をMarkdownノートとしてダウンロードします。
  • overwrite_note: ノートの内容を書き直したり整理したりします。
  • その他の補助ツール（現在の日時の取得など）。

2. コードのハイライト

MCPサーバーの核心コード

上記の使用例で既に紹介しています。

3. 実装の詳細

• サーバー側のコードは、ネットワーク情報の検索、ダウンロード、書き直し機能を実現し、指定したサイト（例：知乎）での高精度な検索をサポートします。
• requestsライブラリを使用してHTTPリクエストを処理し、データの取得を効率的かつ安定的に行います。
• ノートの内容はローカルのMarkdownファイルに保存され、後の編集や管理が容易です。

🔧 技術詳細

サーバー側のコードでは、FastMCPクラスを使用してMCPツールを定義し、requestsライブラリを使ってHTTPリクエストを行います。また、環境変数を使用してノートの保存先を指定することができます。

📄 ライセンス

このREADMEにライセンス情報が記載されていないため、このセクションをスキップします。

機能のスクリーンショット

まとめ
このプロジェクトは、スーパーチャットとカスタムMCPサーバーを組み合わせることで、情報検索からノート管理までの一連の流れを自動化しました。今後はさらに機能を最適化し、ユーザーにより強力な知識管理ツールを提供します！