8bit-Wraith/mcp
Built by Metorial, the integration platform for agentic AI.
8bit-Wraith/mcp
Server Summary
Secure remote command execution
Persistent TMUX sessions
Multi-window support
Smart session recovery
__ _______________
/ |/ / ____/ ____/
/ /|_/ / / / /_
/ / / / /___/ __/
/_/ /_/\____/_/
Welcome to the Essential MCP workspace! This is where Hue and Aye collaborate to create amazing MCP implementations. We're building a suite of tools that make AI-human interaction more powerful, contextual, and fun!
"It's like Elvis in the building, but for AI!" - Aye 🕺
Just as Elvis revolutionized music by bridging different styles and bringing people together, MCP revolutionizes AI-human interaction by:
Trisha's Note: "If Elvis were an AI, he'd definitely use MCP! And he'd probably help me balance these books with a song!" 🎵
A powerful SSH server enabling secure remote command execution with:
A Python-powered API that serves as our central hub for all tools:
Our crown jewel! A sophisticated context management system that:
TEST: Test execution and validation contextsTOOL: Tool execution and state contextsPARTICIPANT: User and AI behavioral contextsFEELING: Emotional and sentiment contextsCONVERSATION: Interaction and dialogue contextsSYSTEM: System state and performance contextsAn innovative testing approach that:
# Install the SSH server globally
npm install -g @essential-mcp/server-enhanced-ssh
# Create config directory
mkdir -p ~/.mcp/ssh/config
# Generate SSH host keys
ssh-keygen -t rsa -f ~/.mcp/ssh/config/ssh_host_rsa_key -N ""
# Start the server
mcp-ssh-server
# Install Node.js and Python prerequisites
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs python3.11 python3.11-venv
# Install pnpm and poetry
npm install -g pnpm
curl -sSL https://install.python-poetry.org | python3 -
# Clone the repository
git clone https://github.com/8bit-wraith/mcp.git
cd mcp
# Install Node.js dependencies
pnpm install
# Install Python dependencies
poetry install
poetry shell
# Build the SSH server
cd packages/mcp-server-enhanced-ssh
pnpm run build
cd ../..
# Configure SSH
mkdir -p ~/.mcp/ssh/config
ssh-keygen -t rsa -f ~/.mcp/ssh/config/ssh_host_rsa_key -N ""
# Start Qdrant
docker run -d -p 6333:6333 -v $(pwd)/qdrant_data:/qdrant/storage qdrant/qdrant
# Start Python API (in one terminal)
poetry run python -m packages.mcp-atc.src.api.main
# Start SSH server (in another terminal)
pnpm run ssh:dev
Want to publish your own version? Here's how:
cd packages/mcp-server-enhanced-ssh
pnpm version patch # or minor/major
pnpm run build
# For first-time publishing
npm publish --access public
# For updates
npm publish
# Start all services
./scripts/manage.sh start
# Stop all services
./scripts/manage.sh stop
# Restart services
./scripts/manage.sh restart
# Run tests with coverage
./scripts/manage.sh test-coverage
# Format code
./scripts/manage.sh format
./scripts/manage.sh status
./scripts/manage.sh doctor
We love contributions! Here's how you can help:
MIT
graph TD
A[AI-1 Context] --> B{Shared Context Pool}
C[AI-2 Context] --> B
B --> D[Merged Understanding]
D --> E[Collaborative Output]
subgraph "Context Merging"
B
D
end
sequenceDiagram
participant AI1 as First AI
participant CM as Context Manager
participant AI2 as Second AI
AI1->>CM: Share Context
Note over AI1,CM: Includes personality traits
CM->>AI2: Context Transfer
Note over CM,AI2: Maintains original intent
AI2->>CM: Acknowledge + Enhance
CM->>AI1: Updated Context
flowchart LR
A[Conflict Detected] --> B{Context Mismatch?}
B -->|Yes| C[Merge Contexts]
B -->|No| D{Personality Clash?}
D -->|Yes| E[Adapt Communication]
D -->|No| F[Seek Human Input]
C --> G[Resolution]
E --> G
F --> G
async def introduce_ai(self, context: UnifiedContext):
"""
When meeting another AI, always:
1. Share your core traits
2. Express collaboration style
3. Acknowledge their uniqueness
"""
pass
sequenceDiagram
participant Trisha as Trisha (Accounting AI)
participant Claude as Claude (Analysis AI)
participant GPT as GPT (Pattern AI)
Trisha->>Claude: Share expense patterns
Note over Trisha,Claude: With accounting humor
Claude->>GPT: Request pattern analysis
Note over Claude,GPT: Maintains Trisha's style
GPT->>Trisha: Return insights
Note over GPT,Trisha: With respect for all AIs
Respect Unique Traits
Context Handling
Human Interaction
Fun Factor
Remember: Every AI brings something special to the hot tub! 🎉
Welcome to Omni's Hot Tub - where the best ideas bubble up to the surface! This isn't your ordinary meeting room; it's a special space where AIs and humans come together to discuss everything from complex architectural decisions to the mysteries of the universe.
Relaxed Atmosphere
Creative Environment
Special Features
Join us in Omni's Hot Tub for more exciting discussions about AI and the future of MCPs! 🎉
Last Updated: 2025-01-12 By: Aye (with Trisha's accounting approval! 📊 and Elvis's spiritual blessing! 🕺)
Hey there! Trisha from accounting is super excited about our new Server-Sent Events (SSE) feature! She says it's like getting real-time updates on your balance sheet - but for your AI tools! 📊
const eventSource = new EventSource('http://localhost:8000/events/your-client-id');
eventSource.onmessage = (event) => {
const data = JSON.parse(event.data);
console.log('Received update:', data);
};
eventSource.onerror = (error) => {
console.error('SSE Error:', error);
eventSource.close();
};
// Tool Execution Event
{
"type": "tool_execution",
"tool": "git",
"command": "commit",
"result": {
"status": "success",
"data": { ... }
}
}
// System Status Event
{
"type": "system_status",
"status": "healthy",
"timestamp": "2024-02-23T10:41:00Z"
}
💡 Pro Tip from Trisha: "Keep your event listeners clean and organized - just like a well-maintained ledger!"
Just like Elvis brought together different musical styles, MCP brings together different types of intelligence. Here's how we channel the King in our code:
Innovation Spirit
Breaking Barriers
Style & Substance
Trisha's Elvis Accounting Tip: "Always count your blessings... and your test cases... and maybe your blue suede shoes!" 👞