Morpho

🚀 Morpho API MCP Server

This project provides a server that allows users to query Morpho's market data through GraphQL, with comprehensive support for vaults, positions, and transactions.

🚀 Quick Start

This server enables users to query Morpho's market data via GraphQL, with full support for vaults, positions, and transactions.

✨ Features

• Query Morpho's market data via GraphQL.
• Fully support vaults, positions, and transactions.
• Provide historical APY data and oracle information.
• Offer comprehensive pagination, sorting, and filtering options.
• Use Zod schemas for data validation.
• Implement error handling and type safety.
• Adhere to the MCP standard for server implementation.

📦 Installation

1. Install the package:

npm install mcp-morpho-server

2. Add it to the Claude Desktop configuration:

{
  "tools": {
    "morpho": {
      "command": "node",
      "args": [
        "/path/to/node_modules/mcp-morpho-server/build/index.js"
      ]
    }
  }
}

💻 Usage Examples

Available Tools

Market Data

• get_markets: Retrieve all markets, supporting pagination and filtering.
• get_whitelisted_markets: Get markets restricted to the whitelist.
• get_market_positions: Obtain position information for a specific market.
• get_historical_apy: Fetch historical annual percentage yield data.
• get_oracle_details: Retrieve detailed oracle information.

Vault-related

• get_vaults: Get all vaults and their current states.
• get_vault_positions: Obtain position information for a specific vault.
• get_vault_transactions: Fetch the transaction history of a vault.
• get_vault_allocation: Retrieve detailed asset allocation information for a vault.
• get_vault_reallocates: Get the historical records of vault reallocations.
• get_vault_apy_history: Fetch the historical annual percentage yield data of a vault.

Assets and Accounts

• get_asset_price: Get the current asset price and yield information.
• get_account_overview: Obtain account positions and transaction records.
• get_liquidations: Retrieve information on liquidation events.

📚 Documentation

Development Guide

This project is written in TypeScript and uses the following technologies:

• @modelcontextprotocol/sdk for MCP server implementation.
• axios for API requests.
• zod for data validation.

Steps to build from source code:

1. Clone the repository:

git clone https://github.com/crazyrabbitLTC/mcp-morpho-server.git

2. Install dependencies:

npm install

3. Build the project:

npm run build

🤝 Contribution Guide

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

ISC

🙋‍♂️ Author Information

Created by Your Name