Chatdata MCP Server

🚀 ChatData MCP 服務器

ChatData MCP 服務器是一款基於 Model Control Protocol (MCP) 的服務應用程序，集成了豐富的工具集和提示系統，旨在增強大型語言模型的功能，為用戶提供更強大、靈活的交互體驗。

🚀 快速開始

ChatData MCP 服務器是一個靈活的框架，支持通過 MCP 協議與大型語言模型進行交互。它具備執行工具函數、使用提示模板、訪問資源等核心功能，支持 stdio 和 SSE 兩種通信模式。

✨ 主要特性

• 執行工具函數：提供多種預定義工具，如網絡操作、數據處理等。
• 使用提示模板：內置多種提示模板，幫助快速生成高質量回復。
• 訪問資源：可以直接訪問文本、二進制數據和動態生成內容。
• 通信方式：支持 stdio 和 SSE 兩種通信模式。

🔧 技術細節

核心組件

工具系統

工具系統分為多個類別：

• 網絡工具：包括網頁抓取、IP 信息查詢、HTTP 客戶端等。
• 數據處理工具：提供數據轉換、文本摘要和計算器功能。
• 開發輔助工具：支持代碼格式化和 PostgreSQL 數據庫查詢。
• 多媒體工具：可生成圖像。
• 實用工具：包含翻譯和天氣查詢等功能。

提示系統

提示系統提供了多種預設模板，用於快速生成高質量回復。每個提示都有具體的描述和參數說明。

資源系統

資源系統允許直接訪問各種數據：

• 文本資源
• 二進制資源
• 動態生成資源

服務器組件

服務器支持兩種通信方式：

• 默認 stdio 模式：無需額外配置，直接使用。
• SSE 模式：通過指定端口啟動。

📦 安裝指南

1. 創建虛擬環境並激活。
2. 使用 pip 安裝項目依賴。
3. 根據需要選擇通信模式啟動服務器：
   • 默認 stdio 模式：python main.py
   • 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 許可證，允許自由使用和修改。