NousResearch/atropos
1
0
Fork 0
mirror of https://github.com/NousResearch/atropos.git synced 2026-04-19 12:57:58 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
atropos/environments/community/router_env/engine/tools/mcp
History
Shannon Sands 7f2e1a4f90 Fix formatting issues in community environments - Applied black, isort, trailing whitespace, and end-of-file fixes - Remaining flake8 issues (unused imports, line length) noted for future cleanup
2025-05-23 13:33:13 +10:00
..
calc Fix formatting issues in community environments - Applied black, isort, trailing whitespace, and end-of-file fixes - Remaining flake8 issues (unused imports, line length) noted for future cleanup 2025-05-23 13:33:13 +10:00
google-maps Fix formatting issues in community environments - Applied black, isort, trailing whitespace, and end-of-file fixes - Remaining flake8 issues (unused imports, line length) noted for future cleanup 2025-05-23 13:33:13 +10:00
perplexity/perplexity-ask Fix formatting issues in community environments - Applied black, isort, trailing whitespace, and end-of-file fixes - Remaining flake8 issues (unused imports, line length) noted for future cleanup 2025-05-23 13:33:13 +10:00
spotify Fix formatting issues in community environments - Applied black, isort, trailing whitespace, and end-of-file fixes - Remaining flake8 issues (unused imports, line length) noted for future cleanup 2025-05-23 13:33:13 +10:00
README.md Fix formatting issues in community environments - Applied black, isort, trailing whitespace, and end-of-file fixes - Remaining flake8 issues (unused imports, line length) noted for future cleanup 2025-05-23 13:33:13 +10:00

README.md

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

Spotify MCP

Basic Memory MCP

Google Maps MCP

  • Repository: (Google Maps implementation)
  • Purpose: Enables interaction with Google Maps for location-based services

Google Calendar MCP

Calculator MCP Server

Usage

These submodules are reference implementations that can be used by Stone AIOS tools. To update all submodules, run:

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