MCP Morpho Server

🚀 Morpho API MCP Server

A Model Context Protocol (MCP) server that provides tools to query the Morpho API. This server enables Claude to access Morpho's API via GraphQL to obtain information such as market data, vaults, and positions.

🚀 Quick Start

This server allows Claude to access Morpho's API through GraphQL, enabling the retrieval of market data, vault information, positions, and more.

✨ Features

• Query Morpho 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 schema for data validation.
• Implement error handling and type safety.
• Provide a server implementation compliant with the MCP standard.

📦 Installation

1. Install the package:

npm install mcp-morpho-server

2. Add it to your Claude Desktop configuration:

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

💻 Usage Examples

Available Tools

Markets

• get_markets: Retrieve all market data, supporting pagination and filtering.
• get_whitelisted_markets: Retrieve market data restricted to the whitelist.
• get_market_positions: Retrieve position information for a specific market.
• get_historical_apy: Retrieve historical APY data.
• get_oracle_details: Retrieve oracle details.

Vaults

• get_vaults: Retrieve all vaults and their current status.
• get_vault_positions: Retrieve position information for a specific vault.
• get_vault_transactions: Retrieve the transaction history of a vault.
• get_vault_allocation: Retrieve the market allocation of a vault.
• get_vault_reallocates: Retrieve the reallocation history of a vault.
• get_vault_apy_history: Retrieve the historical APY data of a vault.

Assets and Accounts

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

🔧 Technical Details

The project is written in TypeScript and uses the following libraries:

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

Building from Source

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

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

📄 License

ISC

👨‍💻 Author

Created by [Your Name] (your@email)