Tweek MCP 服务器

使用说明(简明版,便于快速上手):

  • 项目简介 Tweek 的 MCP 服务器实现旨在给大型语言模型客户端提供统一的上下文服务,包括资源管理、工具注册与执行以及统一的 Prompt 渲染接口,通过 JSON-RPC 协议进行通信。
  • 主要功能点
    • 资源管理与数据访问:托管并提供可读写的资源集合,供 LLM 客户端查询与使用。
    • 工具注册与执行:注册可调用的外部功能并通过服务器转发、执行工具调用。
    • Prompt 模板定义与渲染:提供可定制的 Prompt 模板,支持不同交互模式下的模板渲染。
    • JSON-RPC 通信:客户端发起请求(读取资源、调用工具、获取 Prompts 等),服务器返回结构化的 JSON-RPC 响应或通知。
    • 会话与能力声明:保留会话信息、能力清单,以及对不同传输协议的支持(如 Stdio、SSE、WebSocket)。
  • 安装步骤
    • 需要 Python 3.9+ 环境。
    • 将仓库代码安装到本地环境(建议使用虚拟环境)。
    • 在服务器端运行 MCP 服务入口(根据仓库中的实现入口启动服务,确保依赖就绪)。
  • 服务器配置(MCP 客户端配置示例,JSON 格式;用于 MCP 客户端与 MCP 服务器建立连接,包含 server name、command、args 等字段) 配置示例(JSON,供 MCP 客户端使用): { "server_name": "tweek-mcp-server", "command": "python3", "args": ["-m", "tweek.mcp.gateway"], "transport": "stdio", "description": "MCP 服务器网关,提供资源、工具与提示模板的 MCP 接口", "notes": "客户端通过 JSON-RPC 与该服务器交互,服务器端负责上下文提供、工具执行以及模板渲染。" } 以上配置字段含义:server_name 指定服务器标识;command/args 指定启动该 MCP 服务的命令及参数;transport 指定使用的传输通道;description/notes 提供说明性信息。实际客户端无需修改或依赖此配置细节,但用于集成时可作为连接信息的依据。
  • 基本使用方法
    • 启动 MCP 服务器进程(保持后台运行,确保日志可见)。
    • 客户端通过 JSON-RPC 请求读取资源、调用工具、获取与渲染提示模板等;服务器返回标准的 JSON-RPC 响应。
    • 通过不同传输协议(如 Stdio、SSE、WebSocket)实现与 LLM 客户端的灵活集成。

服务器信息