| Name | mcp-server-aidd JSON |
| Version |
0.1.9
JSON |
| download |
| home_page | None |
| Summary | This MCP server provides a set of tools that support AI-driven Development workflows. |
| upload_time | 2025-01-09 04:24:12 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.12 |
| license | MIT |
| keywords |
ai
aidd
code-analysis
development
mcp
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# AiDD MCP Server
An MCP server that provides a comprehensive set of tools for AI-driven development workflows. Features include file system operations, code analysis using tree-sitter for multiple programming languages, Git operations, code execution, and system information retrieval. Designed to enhance AI's capability to assist in software development tasks.
## Installation
```bash
# Using mcp-get
npx @michaellatman/mcp-get@latest install mcp-server-aidd
# Using pip
pip install mcp-server-aidd
# Using uv
uvx mcp-server-aidd
```
## Claude Desktop Setup
Add to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"mcp-server-aidd": {
"command": "uvx",
"args": ["mcp-server-aidd"]
}
}
}
```
## Key Features
- File system operations (read, write, edit, move, delete)
- Directory management and traversal
- Multi-language code analysis using tree-sitter
- Multi-language code execution with safety measures
- Git operations (status, diff, commit, branch management)
- Security controls with configurable workspace boundaries
## Available Tools
### Basic File Operations
| Tool | Parameters | Returns |
| ------------------- | ----------------------------------- | --------------------------------------------- |
| read_file | path: string | File content |
| read_multiple_files | paths: string[] | Multiple file contents with headers |
| write_file | path: string, content: string | Success confirmation |
| move_file | source: string, destination: string | Success confirmation |
| delete_file | path: string | Success confirmation |
| get_file_info | path: string | File metadata (size, timestamps, permissions) |
Common usage:
```bash
# Read file
aidd-cli --tool read_file --args '{"path": "src/main.py"}'
# Write file
aidd-cli --tool write_file --args '{"path": "output.txt", "content": "Hello World"}'
# Get file info
aidd-cli --tool get_file_info --args '{"path": "src/main.py"}'
```
### Complex File Operations
#### edit_file
Pattern-based file editing with preview support:
```json
{
"path": "src/main.py",
"edits": [
{
"oldText": "def old_function():",
"newText": "def new_function():"
}
],
"dryRun": false,
"options": {
"preserveIndentation": true,
"normalizeWhitespace": true,
"partialMatch": true
}
}
```
Returns: Diff of changes or preview in dry run mode.
### Directory Operations
| Tool | Parameters | Returns |
| ------------------------ | -------------------------------------------------------- | ------------------------------ |
| get_allowed_directory | none | Current allowed directory path |
| update_allowed_directory | directory: string (absolute path) | Success confirmation |
| list_directory | path: string | Directory contents list |
| create_directory | path: string | Success confirmation |
| search_files | pattern: string, path?: string, include_hidden?: boolean | Matching files list |
#### directory_tree
Generates complete directory structure:
```json
{
"path": "src",
"include_hidden": false
}
```
Returns: JSON tree structure of directory contents.
Common usage:
```bash
# List directory
aidd-cli --tool list_directory --args '{"path": "."}'
# Search for Python files
aidd-cli --tool search_files --args '{"pattern": ".py", "path": "src"}'
```
### Git Operations
| Tool | Parameters | Returns |
| ------------ | -------------------------------------- | -------------------------------- |
| git_init | path: string, initial_branch?: string | Repository initialization status |
| git_status | repo_path: string | Working directory status |
| git_add | repo_path: string, files: string[] | Staging confirmation |
| git_reset | repo_path: string | Unstaging confirmation |
| git_checkout | repo_path: string, branch_name: string | Branch switch confirmation |
#### Complex Git Operations
##### git_commit
```json
{
"repo_path": ".",
"message": "feat: add new feature"
}
```
Returns: Commit hash and confirmation.
##### git_diff
```json
{
"repo_path": ".",
"target": "main"
}
```
Returns: Detailed diff output.
##### git_log
```json
{
"repo_path": ".",
"max_count": 10
}
```
Returns: Array of commit entries with hash, author, date, and message.
Common usage:
```bash
# Check status
aidd-cli --tool git_status --args '{"repo_path": "."}'
# Create and switch to new branch
aidd-cli --tool git_create_branch --args '{"repo_path": ".", "branch_name": "feature/new-branch"}'
```
### Code Analysis
#### tree_sitter_map
Analyzes source code structure:
```json
{
"path": "src"
}
```
Returns:
- Classes and their methods
- Functions and parameters
- Module structure
- Code organization statistics
- Inheritance relationships
Supported Languages:
- Python (.py)
- JavaScript (.js, .jsx, .mjs, .cjs)
- TypeScript (.ts, .tsx)
- Java (.java)
- C++ (.cpp, .hpp, .cc)
- Ruby (.rb, .rake)
- Go (.go)
- Rust (.rs)
- PHP (.php)
- C# (.cs)
- Kotlin (.kt, .kts)
### System Information
| Tool | Parameters | Returns |
| --------------- | ---------- | ---------------------------- |
| get_system_info | none | Comprehensive system details |
Returns:
```json
{
"working_directory": "/path/to/project",
"system": {
"os", "os_version", "architecture", "python_version"
},
"wifi_network": "MyWiFi",
"cpu": {
"physical_cores", "logical_cores", "total_cpu_usage"
},
"memory": { "total", "available", "used_percentage" },
"disk": { "total", "free", "used_percentage" },
"mac_details": { // Only present on macOS
"model": "Mac mini",
"chip": "Apple M2",
"serial_number": "XXX"
}
}
```
Provides essential system information in a clean, readable format.
```bash
# Get system information
aidd-cli --tool get_system_info
```
### Code Execution
#### execute_code
Executes code in various programming languages with safety measures and restrictions.
```json
{
"language": "python",
"code": "print('Hello, World!')",
"timeout": 5
}
```
**Supported Languages:**
- Python (python3)
- JavaScript (Node.js)
- Ruby
- PHP
- Go
- Rust
**Parameters:**
| Parameter | Type | Required | Description |
|-----------|---------|----------|---------------------------------------|
| language | string | Yes | Programming language to use |
| code | string | Yes | Code to execute |
| timeout | integer | No | Maximum execution time (default: 5s) |
**Example Usage:**
```bash
# Python example
aidd-cli --tool execute_code --args '{
"language": "python",
"code": "print(sum(range(10)))"
}'
# JavaScript example
aidd-cli --tool execute_code --args '{
"language": "javascript",
"code": "console.log(Array.from({length: 5}, (_, i) => i*2))"
}'
# Ruby example
aidd-cli --tool execute_code --args '{
"language": "ruby",
"code": "puts (1..5).reduce(:+)"
}'
# Go example
aidd-cli --tool execute_code --args '{
"language": "go",
"code": "fmt.Println(\"Hello, Go!\")"
}'
```
**Requirements:**
- Respective language runtimes must be installed
- Commands must be available in system PATH
- Proper permissions for temporary file creation
⚠️ **Security Warning:**
This tool executes arbitrary code on your system. Always:
1. Review code thoroughly before execution
2. Understand the code's purpose and expected outcome
3. Never execute untrusted code
4. Be aware of potential system impacts
5. Monitor execution output
## Configuration
Configuration file: `~/.aidd/config.json`
```json
{
"allowed_directory": "/path/to/workspace"
}
```
## CLI Usage
Basic command structure:
```bash
aidd-cli --tool <tool_name> --args '<json_arguments>'
# List available tools
aidd-cli --list-tools
# Enable debug output
aidd-cli --debug --tool <tool_name> --args '<json_arguments>'
```
## Debugging
Use MCP Inspector for debugging:
```bash
npx @modelcontextprotocol/inspector run
```
## Security
- Operations restricted to configured allowed directory
- Path traversal prevention
- File permission preservation
- Safe operation handling
## Upcoming Features
- GitHub tools:
- PR Description Generator
- Code Review
- Actions Manager
- Pivotal Tracker tools:
- Story Generator
- Story Manager
## Development Status
Currently in active development. Features and API may change.
## License
MIT License - see [LICENSE](LICENSE)
Raw data
{
"_id": null,
"home_page": null,
"name": "mcp-server-aidd",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "ai, aidd, code-analysis, development, mcp",
"author": null,
"author_email": "\"SkyDeck.ai\" <support@skydeck.ai>",
"download_url": "https://files.pythonhosted.org/packages/87/18/0879ac2207d21ff21296e74d5be44b2361533f5d3a01277fed2c0a48cf7a/mcp_server_aidd-0.1.9.tar.gz",
"platform": null,
"description": "# AiDD MCP Server\n\nAn MCP server that provides a comprehensive set of tools for AI-driven development workflows. Features include file system operations, code analysis using tree-sitter for multiple programming languages, Git operations, code execution, and system information retrieval. Designed to enhance AI's capability to assist in software development tasks.\n\n## Installation\n\n```bash\n# Using mcp-get\nnpx @michaellatman/mcp-get@latest install mcp-server-aidd\n\n# Using pip\npip install mcp-server-aidd\n\n# Using uv\nuvx mcp-server-aidd\n```\n\n## Claude Desktop Setup\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"mcp-server-aidd\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-aidd\"]\n }\n }\n}\n```\n\n## Key Features\n\n- File system operations (read, write, edit, move, delete)\n- Directory management and traversal\n- Multi-language code analysis using tree-sitter\n- Multi-language code execution with safety measures\n- Git operations (status, diff, commit, branch management)\n- Security controls with configurable workspace boundaries\n\n## Available Tools\n\n### Basic File Operations\n\n| Tool | Parameters | Returns |\n| ------------------- | ----------------------------------- | --------------------------------------------- |\n| read_file | path: string | File content |\n| read_multiple_files | paths: string[] | Multiple file contents with headers |\n| write_file | path: string, content: string | Success confirmation |\n| move_file | source: string, destination: string | Success confirmation |\n| delete_file | path: string | Success confirmation |\n| get_file_info | path: string | File metadata (size, timestamps, permissions) |\n\nCommon usage:\n\n```bash\n# Read file\naidd-cli --tool read_file --args '{\"path\": \"src/main.py\"}'\n\n# Write file\naidd-cli --tool write_file --args '{\"path\": \"output.txt\", \"content\": \"Hello World\"}'\n\n# Get file info\naidd-cli --tool get_file_info --args '{\"path\": \"src/main.py\"}'\n```\n\n### Complex File Operations\n\n#### edit_file\n\nPattern-based file editing with preview support:\n\n```json\n{\n \"path\": \"src/main.py\",\n \"edits\": [\n {\n \"oldText\": \"def old_function():\",\n \"newText\": \"def new_function():\"\n }\n ],\n \"dryRun\": false,\n \"options\": {\n \"preserveIndentation\": true,\n \"normalizeWhitespace\": true,\n \"partialMatch\": true\n }\n}\n```\n\nReturns: Diff of changes or preview in dry run mode.\n\n### Directory Operations\n\n| Tool | Parameters | Returns |\n| ------------------------ | -------------------------------------------------------- | ------------------------------ |\n| get_allowed_directory | none | Current allowed directory path |\n| update_allowed_directory | directory: string (absolute path) | Success confirmation |\n| list_directory | path: string | Directory contents list |\n| create_directory | path: string | Success confirmation |\n| search_files | pattern: string, path?: string, include_hidden?: boolean | Matching files list |\n\n#### directory_tree\n\nGenerates complete directory structure:\n\n```json\n{\n \"path\": \"src\",\n \"include_hidden\": false\n}\n```\n\nReturns: JSON tree structure of directory contents.\n\nCommon usage:\n\n```bash\n# List directory\naidd-cli --tool list_directory --args '{\"path\": \".\"}'\n\n# Search for Python files\naidd-cli --tool search_files --args '{\"pattern\": \".py\", \"path\": \"src\"}'\n```\n\n### Git Operations\n\n| Tool | Parameters | Returns |\n| ------------ | -------------------------------------- | -------------------------------- |\n| git_init | path: string, initial_branch?: string | Repository initialization status |\n| git_status | repo_path: string | Working directory status |\n| git_add | repo_path: string, files: string[] | Staging confirmation |\n| git_reset | repo_path: string | Unstaging confirmation |\n| git_checkout | repo_path: string, branch_name: string | Branch switch confirmation |\n\n#### Complex Git Operations\n\n##### git_commit\n\n```json\n{\n \"repo_path\": \".\",\n \"message\": \"feat: add new feature\"\n}\n```\n\nReturns: Commit hash and confirmation.\n\n##### git_diff\n\n```json\n{\n \"repo_path\": \".\",\n \"target\": \"main\"\n}\n```\n\nReturns: Detailed diff output.\n\n##### git_log\n\n```json\n{\n \"repo_path\": \".\",\n \"max_count\": 10\n}\n```\n\nReturns: Array of commit entries with hash, author, date, and message.\n\nCommon usage:\n\n```bash\n# Check status\naidd-cli --tool git_status --args '{\"repo_path\": \".\"}'\n\n# Create and switch to new branch\naidd-cli --tool git_create_branch --args '{\"repo_path\": \".\", \"branch_name\": \"feature/new-branch\"}'\n```\n\n### Code Analysis\n\n#### tree_sitter_map\n\nAnalyzes source code structure:\n\n```json\n{\n \"path\": \"src\"\n}\n```\n\nReturns:\n\n- Classes and their methods\n- Functions and parameters\n- Module structure\n- Code organization statistics\n- Inheritance relationships\n\nSupported Languages:\n\n- Python (.py)\n- JavaScript (.js, .jsx, .mjs, .cjs)\n- TypeScript (.ts, .tsx)\n- Java (.java)\n- C++ (.cpp, .hpp, .cc)\n- Ruby (.rb, .rake)\n- Go (.go)\n- Rust (.rs)\n- PHP (.php)\n- C# (.cs)\n- Kotlin (.kt, .kts)\n\n### System Information\n\n| Tool | Parameters | Returns |\n| --------------- | ---------- | ---------------------------- |\n| get_system_info | none | Comprehensive system details |\n\nReturns:\n\n```json\n{\n \"working_directory\": \"/path/to/project\",\n \"system\": {\n \"os\", \"os_version\", \"architecture\", \"python_version\"\n },\n \"wifi_network\": \"MyWiFi\",\n \"cpu\": {\n \"physical_cores\", \"logical_cores\", \"total_cpu_usage\"\n },\n \"memory\": { \"total\", \"available\", \"used_percentage\" },\n \"disk\": { \"total\", \"free\", \"used_percentage\" },\n \"mac_details\": { // Only present on macOS\n \"model\": \"Mac mini\",\n \"chip\": \"Apple M2\",\n \"serial_number\": \"XXX\"\n }\n}\n```\n\nProvides essential system information in a clean, readable format.\n\n```bash\n# Get system information\naidd-cli --tool get_system_info\n```\n\n### Code Execution\n\n#### execute_code\n\nExecutes code in various programming languages with safety measures and restrictions.\n\n```json\n{\n \"language\": \"python\",\n \"code\": \"print('Hello, World!')\",\n \"timeout\": 5\n}\n```\n\n**Supported Languages:**\n\n- Python (python3)\n- JavaScript (Node.js)\n- Ruby\n- PHP\n- Go\n- Rust\n\n**Parameters:**\n| Parameter | Type | Required | Description |\n|-----------|---------|----------|---------------------------------------|\n| language | string | Yes | Programming language to use |\n| code | string | Yes | Code to execute |\n| timeout | integer | No | Maximum execution time (default: 5s) |\n\n**Example Usage:**\n\n```bash\n# Python example\naidd-cli --tool execute_code --args '{\n \"language\": \"python\",\n \"code\": \"print(sum(range(10)))\"\n}'\n\n# JavaScript example\naidd-cli --tool execute_code --args '{\n \"language\": \"javascript\",\n \"code\": \"console.log(Array.from({length: 5}, (_, i) => i*2))\"\n}'\n\n# Ruby example\naidd-cli --tool execute_code --args '{\n \"language\": \"ruby\",\n \"code\": \"puts (1..5).reduce(:+)\"\n}'\n\n# Go example\naidd-cli --tool execute_code --args '{\n \"language\": \"go\",\n \"code\": \"fmt.Println(\\\"Hello, Go!\\\")\"\n}'\n```\n\n**Requirements:**\n\n- Respective language runtimes must be installed\n- Commands must be available in system PATH\n- Proper permissions for temporary file creation\n\n\u26a0\ufe0f **Security Warning:**\nThis tool executes arbitrary code on your system. Always:\n\n1. Review code thoroughly before execution\n2. Understand the code's purpose and expected outcome\n3. Never execute untrusted code\n4. Be aware of potential system impacts\n5. Monitor execution output\n\n## Configuration\n\nConfiguration file: `~/.aidd/config.json`\n\n```json\n{\n \"allowed_directory\": \"/path/to/workspace\"\n}\n```\n\n## CLI Usage\n\nBasic command structure:\n\n```bash\naidd-cli --tool <tool_name> --args '<json_arguments>'\n\n# List available tools\naidd-cli --list-tools\n\n# Enable debug output\naidd-cli --debug --tool <tool_name> --args '<json_arguments>'\n```\n\n## Debugging\n\nUse MCP Inspector for debugging:\n\n```bash\nnpx @modelcontextprotocol/inspector run\n```\n\n## Security\n\n- Operations restricted to configured allowed directory\n- Path traversal prevention\n- File permission preservation\n- Safe operation handling\n\n## Upcoming Features\n\n- GitHub tools:\n - PR Description Generator\n - Code Review\n - Actions Manager\n- Pivotal Tracker tools:\n - Story Generator\n - Story Manager\n\n## Development Status\n\nCurrently in active development. Features and API may change.\n\n## License\n\nMIT License - see [LICENSE](LICENSE)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "This MCP server provides a set of tools that support AI-driven Development workflows.",
"version": "0.1.9",
"project_urls": {
"Documentation": "https://github.com/skydeckai/mcp-server-aidd/blob/main/README.md",
"Homepage": "https://github.com/skydeckai/mcp-server-aidd",
"Repository": "https://github.com/skydeckai/mcp-server-aidd"
},
"split_keywords": [
"ai",
" aidd",
" code-analysis",
" development",
" mcp"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "90545375a82ac5365c38a169eb8e9c5ae07311fd659f2cff7855d4edc9397998",
"md5": "9b1ddf560a0375ae4599d37696a2763a",
"sha256": "d87dfc8630846871ca27fa35f0f5a4b17bc59e9749b62de4ca7a5136d9bc6ea3"
},
"downloads": -1,
"filename": "mcp_server_aidd-0.1.9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9b1ddf560a0375ae4599d37696a2763a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 34123,
"upload_time": "2025-01-09T04:24:10",
"upload_time_iso_8601": "2025-01-09T04:24:10.297153Z",
"url": "https://files.pythonhosted.org/packages/90/54/5375a82ac5365c38a169eb8e9c5ae07311fd659f2cff7855d4edc9397998/mcp_server_aidd-0.1.9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "87180879ac2207d21ff21296e74d5be44b2361533f5d3a01277fed2c0a48cf7a",
"md5": "b24d9096b9c3c4b4189e83b84ba77998",
"sha256": "b878c7b41da1c87d5f58aceb120ab71c45022f2e29d5483ed8647603edb703e5"
},
"downloads": -1,
"filename": "mcp_server_aidd-0.1.9.tar.gz",
"has_sig": false,
"md5_digest": "b24d9096b9c3c4b4189e83b84ba77998",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 45690,
"upload_time": "2025-01-09T04:24:12",
"upload_time_iso_8601": "2025-01-09T04:24:12.924444Z",
"url": "https://files.pythonhosted.org/packages/87/18/0879ac2207d21ff21296e74d5be44b2361533f5d3a01277fed2c0a48cf7a/mcp_server_aidd-0.1.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-09 04:24:12",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "skydeckai",
"github_project": "mcp-server-aidd",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "mcp-server-aidd"
}
