ThetaBird_mcp Server Axiom Js

🚀 基于Axiom的MCP服务器

这是一个基于Axiom的MCP服务器的JavaScript版本，它源自官方的Axiom MCP服务器。该服务器允许AI代理通过Axiom处理语言（APL）来查询数据，为数据查询提供了便捷的途径。此实现具备与原版Go语言版本相同的功能，并且以npm模块的形式进行打包，方便在Node.js环境中集成使用。

🚀 快速开始

本服务器可以通过多种方式进行安装和使用，下面将详细介绍不同场景下的操作步骤。

📦 安装指南

MCP配置

你可以直接使用npx运行此MCP服务器。只需将以下配置添加到你的MCP配置文件中：

{
"axiom": {
"command": "npx",
"args": ["-y", "mcp-server-axiom"],
"env": {
"AXIOM_TOKEN": "",
"AXIOM_URL": "https://api.axiom.co",
"AXIOM_ORG_ID": ""
}
}
}

本地开发与测试

安装

使用以下命令进行全局安装：

npm install -g mcp-server-axiom

环境变量

服务器可以通过环境变量进行配置，以下是详细的环境变量说明：

• AXIOM_TOKEN（必需）：你的Axiom API令牌
• AXIOM_ORG_ID（必需）：你的Axiom组织ID
• AXIOM_URL（可选）：自定义Axiom API URL（默认为https://api.axiom.co）
• AXIOM_QUERY_RATE（可选）：每秒查询限制（默认：1）
• AXIOM_QUERY_BURST（可选）：查询突发容量（默认：1）
• AXIOM_DATASETS_RATE（可选）：数据集列表操作每秒（默认：1）
• AXIOM_DATASETS_BURST（可选）：数据集列表突发容量（默认：2）
• PORT（可选）：服务器端口（默认：3000）

本地运行服务器

• 使用环境变量：

export AXIOM_TOKEN=your_token
mcp-server-axiom

• 使用配置文件：

mcp-server-axiom config.json

示例config.json文件内容如下：

{
"token": "your_token",
"url": "https://custom.axiom.co",
"orgId": "your_org_id",
"queryRate": 2,
"queryBurst": 5,
"datasetsRate": 1,
"datasetsBurst": 2
}

💻 使用示例

工具调用示例

基础用法

• 查询APL：

curl -X POST http://localhost:3000/tools/queryApl/call \
-H "Content-Type: application/json" \
-d '{
"arguments": {
"query": "['logs'] | where ['severity'] == \"error\" | limit 10"
}
}'

• 列出数据集：

curl -X POST http://localhost:3000/tools/listDatasets/call \
-H "Content-Type: application/json" \
-d '{
"arguments": {}
}'

📚 详细文档

API端点

• GET /：获取服务器实现信息
• GET /tools：列出可用工具
• POST /tools/:name/call：调用特定工具
  • 可用工具：
    • queryApl：执行APL查询
    • listDatasets：列出可用数据集

📄 许可证

本项目采用MIT许可证。