Alloy MCP Examples

A comprehensive collection of examples demonstrating how to integrate and use Alloy's Model Context Protocol (MCP) servers in various applications and frameworks.

🚀 Quick Start

# Clone the repository
git clone https://github.com/alloy-automation/mcp-examples
cd mcp-examples

# Install dependencies
pnpm install

# Copy environment variables (already pre-configured!)
cp .env.example .env

# All examples use a single .env file from the root

📚 Examples

1. Basic TypeScript

A minimal example showing how to connect to Alloy MCP servers using TypeScript.

Features:

• Basic server connection
• Tool discovery and invocation
• Error handling
• Response streaming

pnpm run example:basic

2. Next.js Chat Application

A full-featured chat application built with Next.js and Alloy MCP.

Features:

• Real-time chat interface
• Multiple MCP server support
• Tool execution visualization

cd examples/nextjs-chat
pnpm install
pnpm dev

3. Python SDK

Python implementation for Alloy MCP integration.

Features:

• Python MCP client
• Async/await support
• Tool discovery
• Workflow execution

cd examples/python-sdk
pip install -r requirements.txt
python main.py

🏗️ Architecture

graph TB
    A[Client Application] --> B[Alloy MCP Client]
    B --> C[MCP Server 1]
    B --> D[MCP Server 2]
    B --> E[MCP Server N]

    C --> F[Tools & Resources]
    D --> G[Workflows]
    E --> H[Integrations]

    F --> I[External APIs]
    G --> J[Business Logic]
    H --> K[Third-party Services]

Loading

🔧 Configuration

All examples use a centralized configuration from the root .env file. This simplifies setup and ensures consistency across all examples.

Environment Variables

The project uses these pre-configured values:

# Root .env file (used by all examples)
# MCP Server Configuration
NEXT_PUBLIC_ALLOY_API_KEY=<your_api_key_here>
NEXT_PUBLIC_MCP_SERVER_URL=<your_mcp_server_url>
NEXT_PUBLIC_MCP_ACCESS_TOKEN=<your_mcp_access_token>

🤝 Contributing

We welcome contributions!

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Resources

• Alloy Documentation
• MCP Specification

💬 Support

• Issues: GitHub Issues

---

Built with ❤️ by the Alloy team