Reorganize community environments - Move lean_proof_env, router_env, and philosophical_rlaif_env.py to environments/community/ - Add comprehensive README for community environments - This organizes community-contributed environments into a dedicated community folder for better maintainability and discoverability

This commit is contained in:
Shannon Sands 2025-05-23 13:31:13 +10:00
parent 945ea30c3a
commit e85a170c34
53 changed files with 85 additions and 0 deletions

View file

@ -1,76 +0,0 @@
# MCP Servers Directory
This directory contains all Model Context Protocol (MCP) servers used by the Stone AIOS engine.
## Directory Structure
- `perplexity/`: Perplexity API integration for web search
- `perplexity-ask/`: The MCP server for Perplexity's Ask functionality
- `spotify/`: Spotify API integration for music playback and control
- Additional MCP servers can be added in their own directories
## Important Notes
1. The code in `engine/agents/` is configured to look for MCP servers in this exact location (`engine/tools/mcp/`).
2. The MCP servers are initially defined as git submodules in `stone_aios/tools/mcp/` but are copied here during setup:
- The `start.sh` script copies the servers from their submodule location to this directory.
- It then builds the servers in this location to make them available to the engine.
3. When adding new MCP servers:
- Add them as submodules in `stone_aios/tools/mcp/`
- Update `start.sh` to copy and build them in `engine/tools/mcp/`
- Update the agent code to look for them in this location
## Usage
The MCP servers are automatically started when needed by the engine's agent code through the `run_mcp_servers()` context manager in Pydantic-AI.
# Model Context Protocol (MCP) Submodules
This directory contains various Model Context Protocol (MCP) implementations that Stone AIOS uses to interact with different services.
## Submodules
### Perplexity MCP
- Repository: https://github.com/ppl-ai/modelcontextprotocol.git
- Purpose: Provides integration with Perplexity's search functionality
### Spotify MCP
- Repository: https://github.com/varunneal/spotify-mcp.git
- Purpose: Enables interaction with Spotify's music service
### Basic Memory MCP
- Repository: https://github.com/basicmachines-co/basic-memory.git
- Purpose: Provides memory capabilities for agents
### Google Maps MCP
- Repository: (Google Maps implementation)
- Purpose: Enables interaction with Google Maps for location-based services
### Google Calendar MCP
- Repository: https://github.com/nspady/google-calendar-mcp.git
- Purpose: Provides integration with Google Calendar for managing events and schedules
### Calculator MCP Server
- Repository: https://github.com/githejie/mcp-server-calculator.git
- Purpose: Offers calculation capabilities through the MCP protocol
## Usage
These submodules are reference implementations that can be used by Stone AIOS tools. To update all submodules, run:
```bash
git submodule update --init --recursive
```
## Adding New MCP Implementations
To add a new MCP implementation:
1. Add it as a git submodule:
```
git submodule add <repository-url> tools/mcp/<service-name>
```
2. Update this README.md file to include information about the new submodule