Chatdata MCP Server

🚀 ChatData MCP サーバー

ChatData MCP サーバーは、Model Control Protocol (MCP) に基づくサービスアプリケーションです。豊富なツールセットとプロンプトシステムを統合し、大規模言語モデルの機能を強化することを目的としています。

🚀 クイックスタート

ChatData MCP サーバーは、MCP プロトコルを介して大規模言語モデルとの対話を可能にする柔軟なフレームワークです。以下に、その主な機能を紹介します。

✨ 主な機能

• ツール関数の実行：ネットワーク操作やデータ処理など、複数の事前定義されたツールを提供します。
• プロンプトテンプレートの使用：高品質な応答を迅速に生成するための複数のプロンプトテンプレートが組み込まれています。
• リソースへのアクセス：テキスト、バイナリデータ、動的に生成されたコンテンツに直接アクセスできます。
• 通信方式：stdio と SSE の2つの通信モードをサポートしています。

🔧 技術詳細

ツールシステム

ツールシステムはいくつかのカテゴリに分かれています。

• ネットワークツール：ウェブページのスクレイピング、IP情報の照会、HTTPクライアントなどが含まれます。
• データ処理ツール：データ変換、テキスト要約、計算機機能を提供します。
• 開発支援ツール：コードの整形とPostgreSQLデータベースのクエリをサポートします。
• マルチメディアツール：画像を生成できます。
• ユーティリティツール：翻訳や天気予報の照会などの機能があります。

プロンプトシステム

プロンプトシステムは、高品質な応答を迅速に生成するための複数の事前設定されたテンプレートを提供します。各プロンプトには具体的な説明とパラメータの説明があります。

リソースシステム

リソースシステムは、さまざまなデータに直接アクセスできるようにします。

• テキストリソース
• バイナリリソース
• 動的に生成されたリソース

サーバーコンポーネント

サーバーは2つの通信方式をサポートしています。

• デフォルトのstdioモード：追加の設定なしで直接使用できます。
• SSEモード：ポートを指定して起動します。

📦 インストール

1. 仮想環境を作成してアクティブ化します。
2. pipを使用してプロジェクトの依存関係をインストールします。
3. 必要に応じて通信モードを選択してサーバーを起動します。
   • デフォルトのstdioモード：python main.py
   • SSEモード：python main.py --sse-port 8000

💻 使用例

基本的な使用法

以下は、サーバーを起動するための基本的なコマンドです。

# デフォルトのstdioモードでサーバーを起動
python main.py

高度な使用法

SSEモードでサーバーを起動するには、次のコマンドを使用します。

# SSEモードでサーバーを起動
python main.py --sse-port 8000

📚 ドキュメント

新しいツールの追加

1. tools/ ディレクトリに新しいファイルを作成します。
2. ツールのメイン関数と呼び出し関数を実装します。
3. ツール定義を返して、システムが認識できるようにします。

サンプルコード：

import mcp.types as types

def my_tool_function(args):
    # ツールの実装
    pass

def get_tools():
    return [
        types.Tool(
            name="my_tool",
            description="ツールの説明",
            func=my_tool_function,
            args={
                "arg1": {
                    "type": "string",
                    "description": "引数の説明"
                }
            }
        )
    ]

新しいプロンプトの追加

1. prompts/ ディレクトリに新しいファイルを作成します。
2. プロンプト生成関数を実装します。
3. プロンプト定義を返します。

サンプルコード：

import mcp.types as types

def my_prompt(context=None, topic=None):
    # プロンプトの実装
    pass

def get_prompts():
    return [
        types.Prompt(
            name="my_prompt",
            description="プロンプトの説明",
            func=my_prompt,
            args={
                "context": {
                    "type": "string",
                    "description": "コンテキスト情報"
                }
            }
        )
    ]

新しいリソースの追加

1. resources/ ディレクトリに新しいファイルを作成します。
2. リソースの内容と読み取り関数を定義します。
3. リソース定義を返します。

サンプルコード：

import mcp.types as types

RESOURCES = {
    "my_resource": "リソースの内容"
}

def get_resources():
    return [
        types.Resource(
            uri=f"file://{name}.txt",
            name=name,
            description="リソースの説明",
            mimeType="text/plain"
        )
        for name in RESOURCES.keys()
    ]

def read_resource(name: str) -> str | bytes:
    return RESOURCES.get(name)

📄 ライセンス

このプロジェクトはMITライセンスの下で提供されており、自由に使用および変更することができます。