onerios-mcp-server/README.md

OneriosMCP server providing memory, backlog management, file operations, and utility functions for enhanced AI assistant capabilities

# 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**](https://insiders.vscode.dev/redirect/mcp/install?name=onerios-mcp&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22onerios-mcp-server%22%5D%7D)

### Manual Installation
```bash
# 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`:
```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](https://github.com/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](https://github.com/soma-code/onerios-mcp/issues)
- **Discussions**: [GitHub Discussions](https://github.com/soma-code/onerios-mcp/discussions)
- **NPM Package**: [onerios-mcp-server](https://www.npmjs.com/package/onerios-mcp-server)

## 📄 License

MIT License - see the [LICENSE](https://github.com/soma-code/onerios-mcp/blob/main/LICENSE) file for details.

---

**Made with ❤️ for enhanced AI development workflows**