Fibrous MCP Server

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

• Fibrous Finance - Main website
• Documentation - API docs
• MCP Protocol - MCP specifications
• Router SDK v0.6.0 - Local SDK documentation

API Endpoints:

• https://api.fibrous.finance (200 req/min)
• https://graph.fibrous.finance

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.