FigureMarkets-MCP-Server

FigureMarkets-MCP-Server

一个 MCP 服务，让 MCP-enabled AI-Agent 能够轻松获取 Figure Markets 和 Provenance Blockchain 的数据。

安装

注意：仅在搭载 M1 的 MacOS 15.5 笔记本电脑上，作为本地 stdio MCP 服务进行过测试。

安装说明使用 brew 和 uv。 （……请自行尝试，后果自负 ;-) ）

注意：此 MCP 服务仅使用 Anthropic 的 MacOS 版 Claude 桌面应用进行过测试。

安装 MacOS 版 Claude 桌面应用：

https://claude.ai/download

The MCP server is implemented with the MCP Python SDK (https://github.com/modelcontextprotocol/python-sdk)

Make sure you have homebrew installed.

https://docs.brew.sh/Installation

Make sure your python3 is "better" than the one that comes standard with MacOS - if not:

brew install python3

Make sure uv is installed - if not:

brew install uv

Clone this repo someplace on your computer and change directory into the cloned-repo:

git clone https://github.com/franks42/FigureMarkets-MCP-Server.git

cd FigureMarkets-MCP-Server

Install MCP Python SDK packages with uv:

uv add "mcp[cli]"

uv add "httpx[cli]"

Use mcp install to add the MCP server configuration to Claude's config file ("/Users/$USERNAME/Library/Application\ Support/Claude/claude_desktop_config.json"):

uv run mcp install server.py

If Claude Desktop is (re-)started then it should automatically pick up the new mcp server coordinates.

Under Claude's chat prompt, there is a "Search and tools" button, which should show a list of tools that shows "FigureMarkets" with all the APIs that are available.

You can also test it by asking:

What is the current HASH price on the Figure Market exchange?

To test the mcp server standalone thru a webpage use:

uv run mcp dev server.py

Usage

When Claude recognizes the FM mcp server, it will make use of the API when it needs to obtain data from the FM or PB.

For normal interactions, you should just try some of the example questions.

When Claude uses the mcp server apis.

In order for Claude to "know" when to call the mcp server's API, it will use the documentation strings of the APIs and the function signatures.

Most important though is the long concise context document in this repo:

""https://raw.githubusercontent.com/franks42/FigureMarkets-MCP-Server/refs/heads/main/FigureMarketsContext.md"

Claude is instructed to read this document before using any of the APIs.

It's worthwhile to look at that document if you want to understand better how Claude determines what to use and when. For normal interactions, you should.

Example Questions to ask Claude

What is the current HASH price on the Figure Markets?

How about ETH and XRD?

How is the overall exchange doing?

In many cases you'll have question about the assets in your wallet. The wallet is identified by an address, which is a looong incomprehensible number of characters. The easiest way to interact with Claude about your wallet, is to give it a name such that you have to copy and paste it once, like:

my wallet address is "pb...123"

After this you can talk about that wallet like:

How much HASH do i have in my wallet?

What assets are in my wallet?

Review my wallet.

What do you think about my delegation amount?

Do I have vesting hash?

What does the vesting schedule look like?

Analyze my wallet's portfolio.

Etc., etc...