MCP Toolkit

English | 中文

概述

MCP Toolkit 是一个全面的模型上下文协议（MCP）服务器实现，提供了丰富的工具集，使AI助手能够与本地系统、文件、数据库以及外部服务进行交互。它旨在通过实际互动扩展AI的能力，同时确保安全性和控制性。

特点

• 文件系统操作

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

• 数据库集成

  • 支持 MySQL
  • 支持 PostgreSQL
  • 支持 Redis
  • 事务管理

• 参数化查询

• GitHub 集成

  • 仓库管理
  • 代码搜索
  • 文件操作
  • 树结构分析

• 网络能力

  • 网页内容提取
  • Brave 搜索集成
  • HTTP 请求处理
  • 代理支持

• 系统工具

  • 命令执行
  • Everything 搜索集成
  • 堆栈跟踪分析
  • 日志系统

安装

npm install mcp-toolkit

配置

在项目中创建一个 config.json 文件：

{
  "workspace": {
    "rootPath": "/path/to/workspace",
    "allowedPaths": ["/allowed/path1", "/allowed/path2"]
  },
  "network": {
    "proxy": "http://proxy-server:port"  // 可选
  },
  "database": {
    "mysql": {
      "host": "localhost",
      "port": 3306,
      "user": "user",
      "password": "password",
      "database": "dbname"
    }
    // 类似的配置用于 PostgreSQL 和 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: 删除仓库

网络工具

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

系统工具

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

安全

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

贡献

欢迎贡献！请阅读我们的贡献指南以获取详细信息。

许可证

MIT 许可证