OneriosMCP Server

A comprehensive Model Context Protocol (MCP) server providing 40 utility tools for enhanced AI assistant capabilities in VS Code.

🚀 Quick Install

One-Click Installation (VS Code)

Click here to install in VS Code

Manual Installation

# Run directly
npx onerios-mcp-server

# Or install globally
npm install -g onerios-mcp-server
onerios-mcp-server

VS Code MCP Configuration

Add to your VS Code mcp.json:

{
  "servers": {
    "onerios-mcp": {
      "command": "npx",
      "args": ["-y", "onerios-mcp-server"],
      "type": "stdio"
    }
  }
}

⚡ Features

🧠 Memory Management (9 tools)

• Persistent Knowledge Graph: Store entities, relationships, and observations
• Context-Aware Conversations: AI remembers previous interactions
• Smart Search: Find relevant information from stored knowledge
• Relationship Mapping: Connect people, projects, and concepts

📊 Project Management (9 tools)

• Issue Tracking: Create and manage project issues
• Task Breakdown: Break down complex work into manageable tasks
• Progress Analytics: Track project completion and velocity
• Status Management: Monitor task states and priorities

📁 File Operations (6 tools)

• Read/Write Files: Full file system access
• Directory Browsing: Navigate and explore directories
• File Search: Find files by patterns and content
• Text Replacement: Search and replace across files

📈 Data Analysis (7 tools)

• JSON Processing: Parse, query, and transform JSON data
• CSV Operations: Convert between JSON and CSV formats
• Data Structure Analysis: Analyze and format data structures
• Query String Parsing: Handle URL parameters and queries

🌐 Web Utilities (5 tools)

• HTTP Requests: GET and POST operations
• URL Validation: Validate and parse URLs
• Domain Extraction: Extract domains from URLs
• Web Content Analysis: Process web-based data

✏️ Text Processing (4 tools)

• Text Analysis: Analyze content structure and patterns
• Format Text: Structure and organize text content
• Pattern Extraction: Find and extract text patterns
• Content Splitting: Break text into manageable segments

🛡️ Security Features

• Timeout Prevention: Built-in timeout mechanisms prevent freezing
• Privacy Protection: Local data storage, no external services
• Clean Shutdown: Graceful error handling and recovery
• Data Isolation: Separate storage per workspace

📋 Requirements

• Node.js: 18.0.0 or higher
• VS Code: With MCP support
• Operating System: Windows, macOS, or Linux

🎯 Use Cases

Development Workflow

• Track project progress with backlog management
• Remember coding patterns and preferences
• Manage file operations and code analysis
• Process development data and configurations

AI Enhancement

• Provide persistent context to AI assistants
• Enable complex multi-step workflows
• Store and recall important information
• Create intelligent, context-aware interactions

Project Management

• Break down features into tasks
• Track development velocity
• Analyze project completion rates
• Manage issue lifecycle

🚀 Getting Started

1. Install: Use the one-click install or npm command
2. Configure: Add to VS Code MCP settings
3. Initialize: Run npx onerios-mcp-server to set up
4. Use: Access 40 tools through GitHub Copilot or compatible MCP clients

📚 Documentation

• GitHub Repository: soma-code/onerios-mcp
• Full Documentation: Available in the repository /docs/ folder
• Setup Guides: Step-by-step installation and configuration
• Troubleshooting: Common issues and solutions

🤝 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• NPM Package: onerios-mcp-server

📄 License

MIT License - see the LICENSE file for details.

Made with ❤️ for enhanced AI development workflows