An open API service indexing awesome lists of open source software.

https://github.com/axone-protocol/axone-mcp

🤖 Axone’s MCP server – gateway to the dataverse for AI-powered tools
https://github.com/axone-protocol/axone-mcp

ai mcp-server s3

Last synced: about 1 month ago
JSON representation

🤖 Axone’s MCP server – gateway to the dataverse for AI-powered tools

Awesome Lists containing this project

README

        

# axone-mcp

> 🤖 [Axone](https://axone.xyz)’s [MCP](https://modelcontextprotocol.io/introduction) server – gateway to the dataverse for AI-powered tools

[![MCP Protocol](https://img.shields.io/badge/MCP-Compatible-green)](https://modelcontextprotocol.io/introduction)
[![Smithery](https://smithery.ai/badge/@axone-protocol/axone-mcp)](https://smithery.ai/server/@axone-protocol/axone-mcp)

[![Version](https://img.shields.io/github/v/release/axone-protocol/axone-mcp?logo=github)](https://github.com/axone-protocol/axone-mcp/releases)
[![Lint](https://img.shields.io/github/actions/workflow/status/axone-protocol/axone-mcp/lint.yml?branch=main&label=lint&logo=github)](https://github.com/axone-protocol/axone-mcp/actions/workflows/lint.yml)
[![Build](https://img.shields.io/github/actions/workflow/status/axone-protocol/axone-mcp/build.yml?branch=main&label=build&logo=github)](https://github.com/axone-protocol/axone-mcp/actions/workflows/build.yml)
[![Test](https://img.shields.io/github/actions/workflow/status/axone-protocol/axone-mcp/test.yml?branch=main&label=test&logo=github)](https://github.com/axone-protocol/axone-mcp/actions/workflows/test.yml)
[![Codecov](https://img.shields.io/codecov/c/github/axone-protocol/axone-mcp?token=6NL9ICGZQS&logo=codecov)](https://codecov.io/gh/axone-protocol/axone-mcp)

[![Conventional commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg?logo=conventionalcommits)](https://conventionalcommits.org)
[![Semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)

[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](https://github.com/axone-protocol/.github/blob/main/CODE_OF_CONDUCT.md)
[![License](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)

## Axone’s MCP server

[Axone](https://axone.xyz)’s [MCP](https://modelcontextprotocol.io/introduction) server is a lightweight implementation that
exposes Axone’s capabilities through the standardized Model-Context Protocol.

```mermaid
flowchart LR
classDef actor stroke:#808
classDef system stroke:#0ff
classDef resource stroke:#f00

actor:::actor@{ shape: stadium, label: "Host with MCP Client
(Claude, IDEs, Tools)" }
mcpServer:::system@{ shape: rounded, label: "Axone
MCP server" }
axone:::system@{ shape: das, label: "🔗 Axone chain" }

actor -- query --> mcpServer

mcpServer -. query .-> axone
```

## Available tools

### `get_resource_governance_code`

Get the governance code attached to the given resource (if any).

#### Input schema

```json
{
"dataverse": {
"type": "string",
"description": "The address of the dataverse contract"
},
"resource": {
"type": "string",
"description": "The DID URI of the resource"
}
}
```

## Installation

Get the latest [release](https://github.com/axone-protocol/axone-mcp/releases) and put it in your $PATH or somewhere you can easily access.

### Usage with Claude

Add this to your `claude_desktop_config.json` [Claude Desktop](https://claude.ai/download) configuration file:

```json
{
"mcpServers": {
"axone": {
"command": "axone-mcp",
"args": [
"serve",
"stdio",
"--node-grpc",
"grpc.dentrite.axone.xyz:443"
]
}
}
}
```

Flags:

- `--node-grpc`: The gRPC endpoint of the Axone node to connect to.

### Run with SSE transport

```sh
axone-mcp serve sse --listen-addr localhost:8080 --node-grpc grpc.dentrite.axone.xyz:443
```

### Run with STDIO transport

```sh
axone-mcp serve stdio --node-grpc grpc.dentrite.axone.xyz:443
```

## Build

- Be sure you have [Golang](https://go.dev/doc/install) installed.
- [Docker](https://docs.docker.com/engine/install/) as well if you want to use the Makefile.

```sh
make build
```