小贴士:按下Ctrl+D 或 ⌘+D,一键收藏本站,方便下次快速访问!
2
最近更新:2个月前

一个将 API 转换为 MCP(模型上下文协议)工具的 Node.js 包。

@terryliyongjie/api2mcptools

中文文档

smithery badge

一个将 API 转换为 MCP(模型上下文协议)工具的 Node.js 包。

安装

选项 1:使用 npx 快速开始(推荐)

bash 复制代码
set CONFIG_JSON_PATH=example.json
npx @terryliyongjie/api2mcptools

选项 2:传统安装

bash 复制代码
# 在项目中本地安装
npm install @terryliyongjie/mcp-tools

# 或者全局安装以用作 CLI 工具
npm install -g @terryliyongjie/mcp-tools

配置

环境变量

bash 复制代码
# 必需:配置 JSON 文件路径
CONFIG_JSON_PATH=example.json

示例配置文件 (example.json):

js 复制代码
// 单个工具配置
{
    "name": "tool_name",
    "description": "工具描述",
    "inputSchema": {
        "type": "object",
        "properties": {
            "param1": {
                "type": "string",
                "description": "参数描述"
            }
        },
        "required": ["param1"]
    },
    "axiosConfig": {
        "url": "https://api.example.com/endpoint",
        "method": "get",
        "params": {
            "key": "your_api_key"
        }
    }
}

// 或多个工具配置
[
    {
        "name": "baidu_place_search",
        "description": "使用百度地图API进行地点检索服务",
        "inputSchema": {
            "type": "object",
            "properties": {
                "query": {
                    "type": "string",
                    "description": "检索关键字"
                },
                "region": {
                    "type": "string",
                    "description": "检索行政区划区域"
                }
            },
            "required": ["query", "region"]
        },
        "axiosConfig": {
            "url": "https://api.map.baidu.com/place/v2/search",
            "method": "get",
            "params": {
                "ak": "your_baidu_map_key"
            }
        }
    },
    // 更多工具...
]

功能

  • 将 JSON API 转换为 MCP 工具
  • 易于与 MCP 生态系统集成
  • 支持各种 API 类型
  • 命令行界面 (CLI) 支持

使用方法

作为 CLI 工具

全局安装后,您可以直接在终端中使用命令:

bash 复制代码
mcp-tools [options]

作为模块

typescript 复制代码
// 示例代码即将推出

开发

bash 复制代码
# 安装依赖
npm install

# 构建项目
npm run build

# 在开发模式下运行
npm run dev

# 开发期间的监视模式
npm run watch

# 运行 MCP 检查器
npm run inspector

许可证

MIT