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 许可证，允许自由使用和修改。