调试工具集

debug-mcp-tools是为debug-mcp服务器提供的开发和调试工具集,包含时间获取和PHP配置检查功能。

  • by wachterjohannes
  • PHP
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 wachterjohannes/debug-mcp-tools

使用说明

调试mcp工具

⚠️ 原型-仅用于测试和讨论目的


用于调试mcp mcp服务器的开发和调试工具。

目的

提供两个基本的调试工具:

  • 时钟工具:使用可自定义的格式和时区获取当前时间
  • PhpConfigTool:检查PHP配置、扩展和环境

特性

  • 支持时区的当前时间检索
  • PHP配置检查(版本、扩展、路径、内存限制)
  • 通过调试mcp服务器自动发现
  • 使用PHP 8进行基于属性的注册

安装

composer require wachterjohannes/debug-mcp-tools

调试mcp服务器启动时,将自动发现这些工具。

可用工具

时钟

以指定的格式和时区获取当前时间。

参数:

  • format (可选,默认值:'Y-m-d H:i:s'):PHP日期格式字符串
  • timezone (可选,默认值:“UTC”):有效的时区标识符

例子:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "clock",
    "arguments": {
      "format": "c",
      "timezone": "Europe/Berlin"
    }
  },
  "id": 1
}

退货:

{
  "time": "2024-11-29T15:30:45+01:00"
}

php_config

获取有关开发环境的PHP配置信息。

参数:

  • section (可选,默认:“常规”):以下之一:
    • general:PHP版本、内存限制、最大执行时间
    • extensions:已加载的PHP扩展列表
    • paths:包括路径和配置文件位置
    • all:所有信息合并

例子:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "php_config",
    "arguments": {
      "section": "general"
    }
  },
  "id": 1
}

退货:

{
  "php_version": "8.2.12",
  "memory_limit": "256M",
  "max_execution_time": "30",
  "zend_version": "4.2.12"
}

注册

工具通过composer.json额外配置注册:

{
  "extra": {
    "wachterjohannes/debug-mcp": {
      "classes": [
        "Wachterjohannes\\DebugMcp\\Tools\\ClockTool",
        "Wachterjohannes\\DebugMcp\\Tools\\PhpConfigTool"
      ]
    }
  }
}

调试mcp服务器扫描已安装的软件包以查找此配置,并自动加载工具。

添加新工具

要向此软件包添加新工具,请执行以下操作:

  1. 在中创建类 src/ 使用工具逻辑
  2. 添加 #[McpTool] SDK中的属性
  3. 将类名添加到 composer.json 额外配置
  4. 使用工具文档更新此README

工具结构示例:

<?php
namespace Wachterjohannes\DebugMcp\Tools;

use Mcp\Capability\Attribute\McpTool;

class MyNewTool
{
    #[McpTool(
        name: 'my_new_tool',
        description: 'Description of what this tool does'
    )]
    public function execute(string $param): array
    {
        return ['result' => 'value'];
    }
}

发展

代码质量

提交前格式化代码:

composer cs-fix

测试工具

通过安装到调试mcp实例中并使用Claude Desktop或直接JSON-RPC消息来测试各个工具。

需求

  • PHP 8.1或更高版本
  • modelcontextprotocol/php-sdk
  • wachterjohannes/debug mcp(用于测试)

仓库

github:https://github.com/wachterjohannes/debug-mcp-tools

许可证

麻省理工学院