Skip to content

albatrossflyon-coder/agentic-rust-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Agentic Rust MCP

Integrates Render, Vercel, Buffer, and Firestore into a unified interface for Claude Code and other AI agents.

✨ All 4 Stages Complete

Stage 1: Foundation ✅

  • Async stdio transport
  • Message loop architecture
  • tokio runtime initialization

Stage 2: Resources & Prompts ✅

  • 3 Read-Only Resources (system status, content schedules, activity logs)
  • 3 Reusable Prompts (deployment analyzer, content scheduler, activity log analyzer)

Stage 3: Tools ✅

  • agency_pulse — Check Render & Vercel deployment status (4 services)
  • content_check — Query Buffer content schedules
  • data_vault — Access Firestore leads & logs

Stage 4: Roof & Finishings ✅

  • Streaming — Real-time updates for long-running tasks
  • OAuth 2.1 — Secure token-based authentication
  • Professional Logging — JSON structured logs for production
  • Tests — 4/4 unit tests passing
  • .env Support — Safe credential management

Quick Start

# Build production binary
cargo build --release

# Copy and configure environment
cp .env.example .env
# Edit .env with your OAuth token and API keys

# Run server
./target/release/agentic-rust-mcp

Usage Examples

Request Resources

{"type": "resource", "name": "system-status"}

Request Prompts

{"type": "prompt", "name": "deployment-analyzer"}

Invoke Tools

{"type": "tool", "name": "agency_pulse", "args": {}}
{"type": "tool", "name": "content_check", "args": {}}
{"type": "tool", "name": "data_vault", "args": {}}

Stream Long-Running Task

{"type": "streaming_task", "task": "process_deployment"}

Returns stream markers:

  • stream_start — Task initiated
  • stream_update — Progress update (3 steps)
  • stream_end — Task completed

Security

OAuth 2.1 Token Management

  • Load from .env (never hardcoded)
  • Verify token validity before requests
  • Support token refresh flow
  • Bearer token authentication

Credential Protection

  • dotenv for safe .env loading
  • .env in .gitignore
  • .env.example for documentation
  • Environment variable support

Performance

Metric Value
Build Time 29.18s (release, LTO)
Test Execution 12.95s
Binary Size ~8MB (release)
Memory ~5-10MB at rest
Tests Passing 4/4 ✅

Logging

JSON Structured Format

{
  "timestamp": "2026-05-05T00:00:00Z",
  "level": "info",
  "target": "agentic_rust_mcp",
  "message": "Tool executed successfully",
  "tool": "agency_pulse",
  "duration_ms": 125
}

Enable/Disable

RUST_LOG=info ./target/release/agentic-rust-mcp
RUST_LOG=debug ./target/release/agentic-rust-mcp

Architecture

┌─────────────────────────────────────────┐
│  Claude Code / AI Agent                 │
└────────────┬────────────────────────────┘
             │ stdio (JSON)
             ↓
┌─────────────────────────────────────────┐
│  Stage 1: Foundation                    │
│  - Async message loop                   │
│  - Type-safe request parsing            │
└─────────────┬───────────────────────────┘
              │
    ┌─────────┼─────────┐
    ↓         ↓         ↓
┌──────┐  ┌──────┐  ┌──────┐
│ S2   │  │ S3   │  │ S4   │
│─────┐│  │─────┐│  │─────┐│
│Res  ││  │Tool ││  │OAuth││
│Prom ││  │─────││  │Log  ││
│─────││  │agcy ││  │Strm ││
│─────│┘  │cont ││  │─────│┘
│─────│   │data ││  │─────│
└─────┘   └─────┘│  └─────┘
                 │
    ┌────────────┼────────────┐
    ↓            ↓            ↓
[ Render ]  [ Vercel ]   [ Buffer + Firestore ]

This server is the final layer in a larger, multi-project memory architecture spanning research (NotebookLM), session state (OB1 + Supabase), and a RAG engine — see docs/memory-architecture.md for the full picture.

Resume Impact

  • Agentic AI Standard — Implements 2026 MCP protocol
  • Production-Ready — Type-safe, async, tested, secured
  • Multi-Stage Build — Shows modular architecture discipline
  • Tool Integration — DevOps + Content + Data orchestration
  • Security First — OAuth 2.1, env vars, no secrets in code
  • Observable — Structured JSON logging for monitoring

Tech Stack

Layer Technology
Runtime tokio (async/await)
Serialization serde + schemars
HTTP reqwest
Logging tracing + tracing-subscriber
Security dotenv, OAuth 2.1
Testing built-in cargo test
IDs uuid v4
Timestamps chrono

License

MIT

Author

Chris Brown
Albatross AI
Portfolio

About

Production-grade Rust MCP server for agentic AI pipelines. Integrates Render, Vercel, Buffer, and Firestore.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages