ilia/atlas

ilia 4b9ffb5ddf docs: Update architecture and add new documentation for LLM and MCP

- Enhanced `ARCHITECTURE.md` with details on LLM models for work (Llama 3.1 70B Q4) and family agents (Phi-3 Mini 3.8B Q4).
- Introduced new documents:
  - `ASR_EVALUATION.md` for ASR engine evaluation and selection.
  - `HARDWARE.md` outlining hardware requirements and purchase plans.
  - `IMPLEMENTATION_GUIDE.md` for Milestone 2 implementation steps.
  - `LLM_CAPACITY.md` assessing VRAM and context window limits.
  - `LLM_MODEL_SURVEY.md` surveying open-weight LLM models.
  - `LLM_USAGE_AND_COSTS.md` detailing LLM usage and operational costs.
  - `MCP_ARCHITECTURE.md` describing the Model Context Protocol architecture.
  - `MCP_IMPLEMENTATION_SUMMARY.md` summarizing MCP implementation status.

These updates provide comprehensive guidance for the next phases of development and ensure clarity in project documentation.

2026-01-05 23:44:16 -05:00

2.1 KiB

Raw Blame History

Ticket: Implement Minimal MCP Server

Ticket Information

ID: TICKET-029
Title: Implement Minimal MCP Server
Type: Feature
Priority: High
Status: Done
Track: Tools/MCP
Milestone: Milestone 1 - Survey & Architecture
Created: 2024-01-XX

Description

Build a minimal MCP server:

One service exposing a few tools (e.g., weather, echo)
JSON-RPC protocol implementation
Tools/call and tools/list endpoints
Basic error handling

Acceptance Criteria

MCP server implemented (home-voice-agent/mcp-server/)
JSON-RPC protocol working (JSON-RPC 2.0 via FastAPI)
Tools/list endpoint functional (/mcp with method tools/list)
Tools/call endpoint functional (/mcp with method tools/call)
At least 2 example tools (weather, echo) implemented
Error handling implemented (proper JSON-RPC error codes)

Technical Details

Implementation:

JSON-RPC 2.0 server
Tool registration system
Request/response handling
Error codes and messages

Dependencies

TICKET-028 (MCP concepts)

home-voice-agent/mcp-server/ (to be created)

home-voice-agent/mcp-server/ (to be created)

Notes

Independent of specific tools - start with stubs. Can be tested with dummy models.

Progress Log

2024-01-XX - MCP server implemented with FastAPI
2024-01-XX - JSON-RPC 2.0 protocol implemented
2024-01-XX - Tool registry system created
2024-01-XX - Echo and Weather tools implemented
2024-01-XX - Test script created (test_mcp.py)
2024-01-XX - Ready for testing and integration

Implementation Details

Location: home-voice-agent/mcp-server/

Components:

server/mcp_server.py - Main FastAPI server with JSON-RPC 2.0 handler
tools/registry.py - Tool registration and execution system
tools/base.py - Base tool interface
tools/echo.py - Echo tool for testing
tools/weather.py - Weather tool (stub implementation)

To Run:

cd home-voice-agent/mcp-server
pip install -r requirements.txt
python server/mcp_server.py

To Test:

python test_mcp.py

2.1 KiB Raw Blame History