Artemis

🚀 Artemis-MCP

     _    ____ _____ _____ __  __ ___ ____    __  __  ____ ____
/ \  |  _ \_   _| ____|  \/  |_ _/ ___|  |  \/  |/ ___|  _ \
/ _ \ | |_) || | |  _| | |\/| || |\___ \  | |\/| | |   | |_) |
/ ___ \|  _ < | | | |___| |  | || | ___) | | |  | | |___|  __/
/_/   \_\_| \_\|_| |_____|_|  |_|___|____/  |_|  |_|\____|_|

Artemis-MCP 是一个强大的工具集，能够与 Artemis API 进行交互，提供验证连接、获取数据以及生成公式等功能，助力用户在加密货币数据处理方面更加高效。

🚀 快速开始

在使用 Artemis-MCP 之前，你需要满足一些先决条件，并完成相应的安装步骤。

✨ 主要特性

• 提供多种 API 工具，可创建并验证与 Artemis API 的连接，获取加密代币相关数据。
• 具备公式生成工具，能生成 ART 和 ARTINFO 公式以满足不同的数据检索需求。

📦 安装指南

使用 OpenTools 自动化（更简单）

此方式更为便捷，你只需安装 OpenTools 先决条件，然后运行以下命令：

npx opentools@latest i artemis

手动设置（更多工作量）

1. 安装 uv：uv 是必要的依赖，在 MacOS 上，你可以使用 Homebrew 安装：brew install uv。
2. 复制配置文件：将 sample_claude_desktop_config.json 复制到你的 claude_desktop_config.json 文件，不同系统的路径如下：
   • 在 MacOS 上：~/Library/Application\ Support/Claude/claude_desktop_config.json
   • 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json
3. 填写配置文件：打开 claude_desktop_config.json，填写以下相关字段：
   • - uv 可执行文件的路径（在 MacOS 上运行 where python）
   • - Artemis MCP 本地克隆仓库的路径
   • - 你的 Artemis API Key
4. 重启 Claude Desktop：完成上述步骤后，重启 Claude Desktop。
5. 验证安装：此时，Artemis MCP 工具应该已经可用！

💻 使用示例

基础用法

以下是使用 API 工具的示例：

# 创建并验证与 Artemis API 的连接
npx opentools@latest artemis validate-artemis-api-key

# 从 Artemis API 获取给定加密代币符号和指标的数据
npx opentools@latest artemis get-artemis-data --symbol BTC --metric price

# 获取指定加密代币符号的支持的指标
npx opentools@latest artemis get-artemis-supported-metrics-for-symbol --symbol ETH

高级用法

以下是使用公式生成工具的示例：

# 生成一个 ART 公式以检索价格、费用、收入和其他时间序列数据
npx opentools@latest artemis generate-art-formula --symbol LTC --metric volume

# 生成一个 ARTINFO 公式以获取资产分类、可用指标、市值排名和元数据
npx opentools@latest artemis generate-artinfo-formula --symbol XRP

📚 详细文档

可用工具

Artemis MCP 服务器提供了以下工具：

API 工具

• validate-artemis-api-key：创建并验证与 Artemis API 的连接。
• get-artemis-data：从 Artemis API 获取给定加密代币符号和指标的数据。
• get-artemis-supported-metrics-for-symbol：获取指定加密代币符号的支持的指标。

公式生成工具

• generate-art-formula：生成一个 ART 公式以检索价格、费用、收入和其他时间序列数据。
• generate-artinfo-formula：生成一个 ARTINFO 公式以获取资产分类、可用指标、市值排名和元数据。

🔧 技术细节

先决条件

• Python 3.11+：作为运行环境的基础，确保工具的正常运行。
• uv：一个重要的依赖项，可从 uv 官方文档 了解安装方法，在 MacOS 上可以使用 Homebrew 安装：brew install uv。
• Claude Desktop：为工具的使用提供必要的桌面环境。
• Artemis API Key：用于与 Artemis API 进行身份验证和数据交互。
• Artemis Snowflake 登录：确保能够访问相关的 Snowflake 数据。

安装方式

提供了自动化和手动两种安装方式，用户可以根据自己的需求和技术水平进行选择。自动化安装借助 OpenTools，操作简单；手动安装则需要更多的步骤，但能让用户更深入地了解工具的配置过程。

工具原理

API 工具通过与 Artemis API 进行交互，发送请求并获取响应，从而实现验证连接和获取数据的功能。公式生成工具则根据用户提供的参数，生成相应的 ART 和 ARTINFO 公式，方便用户进行数据检索和分析。

⚙️ 配置文件说明

claude_desktop_config.json

该配置文件包含了 Artemis-MCP 运行所需的重要信息，如 uv 可执行文件的路径、本地克隆仓库的路径以及 Artemis API Key 等。在使用手动安装方式时，需要仔细填写这些字段，以确保工具能够正常工作。

📄 许可证

原文档未提及许可证相关信息。