AI助手交互工具包

MCP Toolkit是一个全面的模型上下文协议服务器实现,为AI助手提供与本地系统、文件、数据库和外部服务交互的丰富工具集,旨在扩展AI的现实交互能力同时保持安全性和控制。

  • by zxfgds
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 zxfgds/mcp-toolkit

使用说明

MCP工具包

英语| 中文

概述

MCP Toolkit是一个全面的模型上下文协议(MCP)服务器实现,为AI助手提供了一套丰富的工具,用于与本地系统、文件、数据库和外部服务进行交互。它旨在通过现实世界的交互扩展人工智能功能,同时保持安全性和控制性。

特性

  • 文件系统操作

    • 读取和写入文件
    • 创建和删除目录
    • 使用正则表达式模式搜索文件
    • 列出目录内容
    • 提取代码定义
  • 数据库集成

    • MySQL支持
    • PostgreSQL支持
    • Redis支持
    • 交易管理
    • 参数化查询
  • GitHub集成

    • 存储库管理
    • 代码搜索
    • 文件 操作
    • 树形结构分析
  • Web功能

    • 网页内容提取
    • 勇敢的搜索集成
    • HTTP请求处理
    • 代理支持
  • 系统工具

    • 命令执行
    • 一切搜索集成
    • 堆栈跟踪分析
    • 测井系统

安装

npm install mcp-toolkit

配置

创建一个 config.json 项目中的文件:

{
  "workspace": {
    "rootPath": "/path/to/workspace",
    "allowedPaths": ["/allowed/path1", "/allowed/path2"]
  },
  "network": {
    "proxy": "http://proxy-server:port"  // Optional
  },
  "database": {
    "mysql": {
      "host": "localhost",
      "port": 3306,
      "user": "user",
      "password": "password",
      "database": "dbname"
    }
    // Similar configuration for PostgreSQL and Redis
  }
}

用法

import { Server } from 'mcp-toolkit';

const server = new Server({
  configPath: './config.json'
});

server.start();

工具详细信息

文件操作工具

  • read_file:读取文件内容,支持文本和二进制文件
  • write_to_file:写入或创建文件
  • apply_diff:对文件应用差异修改
  • insert_content:在指定位置插入内容
  • search_and_replace:搜索和替换文件内容
  • list_files:列出目录内容
  • search_files:使用正则表达式搜索文件
  • list_code_definition_names:提取代码定义

数据库工具

  • db_connect:连接到数据库(MySQL/PostgreSQL/Redis)
  • db_query:执行数据库查询
  • db_begin_transaction:开始交易
  • db_commit_transaction:提交交易
  • db_rollback_transaction:回滚交易
  • db_close:关闭数据库连接

GitHub工具

  • github_ls:列出存储库内容
  • github_tree:显示存储库树结构
  • github_search_repo:搜索存储库
  • github_search_code:搜索代码
  • github_cat:查看文件内容
  • github_list_repos:列出用户存储库
  • github_create_repo:创建存储库
  • github_update_repo:更新存储库设置
  • github_delete_repo:删除存储库

Web工具

  • read_webpage:提取网页内容
  • brave_search:使用Brave搜索
  • http_request:发送HTTP请求

系统工具

  • execute_command:执行系统命令
  • everything_search:本地文件搜索
  • logger:日志记录
  • get_stack_trace:堆栈跟踪分析

安全

  • 可配置的工作空间限制
  • 命令执行控制
  • 数据库访问管理
  • 基于令牌的外部服务身份验证

贡献

欢迎投稿!请阅读我们的 贡献指南 了解详情。

许可证

MIT许可证