Mcpixir

🚀 Mcpixir

Mcpixir is an Elixir library designed to control multiple MCP (Message Communication Protocol) implementations and support integration with Large Language Models (LLMs). It aims to simplify complex operations using tools like Playwright.

🚀 Quick Start

Mcpixir offers a straightforward way to get started with controlling multiple MCP implementations and integrating with LLMs. You can explore various functionalities through provided Mix tasks.

✨ Features

• Multiple MCP Implementations Running Simultaneously: Connect and manage multiple MCP services concurrently.
• Remote Connector Testing (HTTP, WebSocket): Interact with remote MCP servers via HTTP and WebSocket protocols.
• LLM Integration Support: Seamlessly connect with large language models such as OpenAI and Anthropic.

💻 Usage Examples

Basic Usage

We provide a series of Mix tasks to demonstrate the usage of different features:

# View all examples
mix mcpixir

# Specific examples
mix mcpixir.chat          # Simple chat interaction
mix mcpixir.airbnb        # Example of Airbnb integration
mix mcpixir.blender       # Control Blender 3D software
mix mcpixir.browser       # Web browsing using Playwright
mix mcpixir.filesystem    # Operate on the file system
mix mcpixir.http          # Example of an HTTP connector
mix mcpixir.multi         # Use multiple MCP servers simultaneously

📚 Documentation

Environment Variables

Set the log level:

export MCP_USE_LOG_LEVEL=debug  # Available values: debug, info, warn, error

Code Configuration

Add the following to config/config.exs:

# Configure logging
config :mcpixir,
  log_level: :debug

🚧 Roadmap

• Completed:
  • Support multiple servers running simultaneously
  • Test remote connectors (HTTP, WebSocket)
• To-Do:
  • [ ] Add more features...

🤝 Contribution Guidelines

We welcome contributions of all forms! Here are the steps to participate in the development:

Development Process

# Clone the repository
git clone https://github.com/yourusername/mcp-use-elixir.git
cd mcp-use-elixir

# Install dependencies
mix deps.get

# Run tests
mix test

# Format the code
mix format

# Check code quality
mix credo

Release Process

The project follows semantic versioning. Here's how to release a new version:

Using Mix Task

mix mcp.release 0.2.0

Using Shell Script

./bin/release.sh 0.2.0

Both methods will perform the following steps:

1. Check if the workspace is clean.
2. Update the version number in mix.exs.
3. Update CHANGELOG.md.
4. Create a Git package and push it to the remote repository.

📄 License

This project is licensed under the MIT License. Please refer to the LICENSE file for specific terms.