Axiom MCP 服务器通过模型上下文协议（MCP）将 AI 助手连接到您的 Axiom 可观测性数据。该仓库包含：

• 一个托管MCP服务器的Cloudflare Workers应用（apps/mcp。
• 一个包含核心MCP工具和工具的TypeScript包（packages/mcp）。

有关安装、设置、支持的工具、认证以及客户端专用说明（Claude、光标、VS Code 等），请参见官方文档：

https://axiom.co/docs/console/intelligence/mcp-server#axiom-mcp-server

欢迎提出问题和贡献。请参见 AGENTS.md 贡献者指南。

• 用于表格数据的CSV格式，取代冗长的JSON
• 自动maxBinAutoGroups用于时间序列聚合
• 智能结果塑造，优先考虑重要领域
• 基于数据量的自适应截断

运行时URL参数

当连接到托管服务器端点（/sse 或 /mcp]）时，你可以通过查询字符串传递运行时调优参数：

• max-age：整数。使用工具渲染的表单元格数上限。示例：?max-age=500。
• with-otel：布尔（1/true）。如果您的组织支持OTel集成，可启用OpenTelemetry工具系列。

                  ███╗   ███╗ ██████╗██████╗
                  ████╗ ████║██╔════╝██╔══██╗
                  ██╔████╔██║██║     ██████╔╝
                  ██║╚██╔╝██║██║     ██╔═══╝
                  ██║ ╚═╝ ██║╚██████╗██║
                  ╚═╝     ╚═╝ ╚═════╝╚═╝
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Model Context Protocol Server ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Axiom, Inc.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

axiom-mcp

The Axiom MCP Server connects AI assistants to your Axiom observability data using the Model Context Protocol (MCP). This repository contains:

• A Cloudflare Workers app that hosts the MCP server (apps/mcp).
• A TypeScript package with core MCP utilities and tools (packages/mcp).

For installation, setup, supported tools, authentication, and client-specific instructions (Claude, Cursor, VS Code, etc.), please see the official documentation:

https://axiom.co/docs/console/intelligence/mcp-server#axiom-mcp-server

Issues and contributions are welcome. See AGENTS.md for contributor guidelines.

• CSV formatting for tabular data instead of verbose JSON
• Automatic maxBinAutoGroups for time-series aggregations
• Intelligent result shaping that prioritizes important fields
• Adaptive truncation based on data volume

Runtime URL Parameters

When connecting to the hosted server endpoints (/sse or /mcp), you can pass runtime tuning parameters via query string:

• max-age: Integer. Caps total table cells rendered by tools. Example: ?max-age=500.
• with-otel: Boolean (1/true). Enables OpenTelemetry tool family if your org has OTel integrations. Example: ?with-otel=1.

Example connection URL (MCP Inspector):

http://localhost:8788/sse?org-id=&max-age=500&with-otel=1

Troubleshooting

Connection Issues

Remote MCP connections are still early. If you experience issues:

1. Try restarting your client
2. Disable and re-enable the Axiom MCP server
3. Check your authentication credentials
4. Try clearing and re-authenticating your client

Authentication Errors

• OAuth: Ensure you’re logged into Axiom in your browser

OR

• Personal Token: Verify your token starts with xapt- and hasn’t expired
• Organization ID: Must match the organization that issued the token

Support

• Documentation
• GitHub Issues
• Community Discord

License

MIT License - see LICENSE file for details.