Fibrous MCP Server

A server for Fibrous Finance, a DeFi aggregation platform.

GitHub

Fibrous MCP Server

Node.js TypeScript License Fibrous SDK Test Coverage

MCP server providing AI agents with tools for multi-chain DeFi operations using the Fibrous SDK.

Features

10 Available Tools:

  • get-supported-tokens - List available tokens
  • get-supported-protocols - List DEX protocols
  • get-best-route - Find optimal swap routes
  • get-best-route-batch - Find optimal routes for batch swaps (Starknet only)
  • build-transaction - Generate transaction data
  • build-batch-transaction - Generate batch transaction data (Starknet only)
  • format-token-amount - Convert between human and wei formats
  • get-token - Fetch token details by address
  • execute-swap - Execute token swaps (requires wallet config)
  • estimate-swap - Estimate gas costs (requires wallet config)

Supported Networks:

  • Base - Uniswap V3, Aerodrome, SwapBased
  • Starknet - JediSwap, MySwap, 10kSwap, Ekubo
  • Scroll - Uniswap V3, SyncSwap, iZiSwap

Quick Start

# Install dependencies
pnpm install

# Configure environment
cp .env.example .env
# Edit .env with your RPC URLs and private keys

# Build the project
pnpm build

# Start server
pnpm start

Configuration

Environment Variables

Core Configuration:

NODE_ENV=development
DEFAULT_SLIPPAGE=1.0

Network Configuration:

# Base Network
BASE_RPC_URL=https://mainnet.base.org
BASE_PRIVATE_KEY=0x...

# Starknet Network
STARKNET_RPC_URL=https://starknet-mainnet.public.blastapi.io
STARKNET_PRIVATE_KEY=0x...
STARKNET_PUBLIC_KEY=0x...

# Scroll Network
SCROLL_RPC_URL=https://rpc.scroll.io
SCROLL_PRIVATE_KEY=0x...

Optional Settings:

# Debug configuration
DEBUG=false
LOG_LEVEL=info
ENABLE_METRICS=false

# API optimization
FIBROUS_API_KEY=your_api_key_here

MCP Client Setup

Add to your MCP client configuration:

{
	"mcpServers": {
		"fibrous-mcp": {
			"command": "node",
			"args": ["/path/to/fibrous-mcp/build/src/index.js"]
		}
	}
}

Development

Prerequisites

  • Node.js 18+
  • pnpm (recommended)
  • TypeScript 5.0+

Setup

# Clone repository
git clone <repository-url>
cd fibrous-mcp

# Install dependencies
pnpm install

# Start development server
pnpm dev

# Watch mode with auto-reload
pnpm dev:watch

Code Quality

# Type checking
pnpm typecheck

# Linting
pnpm lint
pnpm lint:fix

# Code formatting
pnpm format
pnpm format:check

Testing

Comprehensive test suite with 82.6% coverage across all modules:

# Run all tests
pnpm test

# Watch mode for development
pnpm test:watch

# Coverage report
pnpm test:coverage

# CI mode
pnpm test:ci

Test Results:

  • 167/167 tests passing
  • 10 test suites, ~3.1s execution
  • Native BigInt with router-sdk v0.6.0

Test Coverage by Module

  • API endpoints: 17 tests
  • Server configuration: 14 tests
  • Tool handlers: 14 tests
  • Utilities: 122 tests (BigInt operations, configuration, responses, swap logic, validation)

Coverage Details

  • Statements: 82.56%
  • Branches: 73.46%
  • Functions: 75.71%
  • Lines: 83.18%

Technical Details

Native BigInt Integration

  • Router SDK v0.6.0: Latest Fibrous SDK compatibility
  • 50KB smaller bundle: Removed BigNumber.js dependency
  • Faster calculations: Native JavaScript bigint operations
  • Modern standards: ES2022+ features
// Example: Native BigInt usage
const amount = BigInt("1000000000000000000"); // 1 ETH
const route = await router.getBestRoute(amount, tokenIn, tokenOut, "base");

Architecture

  • MCP Protocol: Model Context Protocol compliance
  • Type Safety: Full TypeScript implementation
  • Error Handling: Comprehensive error management
  • Security: Environment variable validation and masking

Production Deployment

Environment Setup

# Production build
pnpm build:clean

# Production start
NODE_ENV=production pnpm start:prod

Security Considerations

  • Store private keys securely (use secrets management)
  • Configure appropriate RPC endpoints
  • Set up monitoring and logging
  • Use HTTPS for all external connections

Performance

  • Native BigInt: 2-3x faster than BigNumber.js
  • Bundle Size: 50KB reduction vs v0.5.x
  • Memory Usage: Optimized for long-running processes
  • Rate Limiting: 200 req/min (configurable)

Resources

API Endpoints:

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests for new functionality
  5. Ensure all tests pass: pnpm test
  6. Submit a pull request

Development Guidelines

  • Follow TypeScript best practices
  • Maintain test coverage above 75%
  • Use conventional commit messages
  • Update documentation for new features

License

MIT - see LICENSE

Risk Warning: DeFi operations involve financial risk. Always verify transactions and use testnet for development.

Status: Production ready with comprehensive test coverage and native BigInt support.

Related Servers