@aithr-ai/mcp-server 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +137 -0
- package/index.js +2178 -0
- package/package.json +40 -0
package/README.md
ADDED
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
# Aether MCP Server
|
|
2
|
+
|
|
3
|
+
Connect [Claude Code](https://claude.com/claude-code) to [Aether](https://www.aithr.ai) - the AI-powered team workspace for software development.
|
|
4
|
+
|
|
5
|
+
## Quick Install
|
|
6
|
+
|
|
7
|
+
### One-Line Setup (Recommended)
|
|
8
|
+
|
|
9
|
+
**Mac/Linux:**
|
|
10
|
+
```bash
|
|
11
|
+
claude mcp add --transport stdio aether \
|
|
12
|
+
--env AETHER_API_KEY=YOUR_API_KEY \
|
|
13
|
+
--env AETHER_WORKSPACE_ID=your-workspace-slug \
|
|
14
|
+
--env AETHER_PROJECT_ID=your-project-uuid \
|
|
15
|
+
-s user \
|
|
16
|
+
-- npx -y @aithr-ai/mcp-server
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
**Windows:**
|
|
20
|
+
```bash
|
|
21
|
+
claude mcp add --transport stdio aether ^
|
|
22
|
+
--env AETHER_API_KEY=YOUR_API_KEY ^
|
|
23
|
+
--env AETHER_WORKSPACE_ID=your-workspace-slug ^
|
|
24
|
+
--env AETHER_PROJECT_ID=your-project-uuid ^
|
|
25
|
+
-s user ^
|
|
26
|
+
-- cmd /c npx -y @aithr-ai/mcp-server
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
### Get Your Credentials
|
|
30
|
+
|
|
31
|
+
1. **API Key**: Go to Aether Settings > API Keys > Create Key
|
|
32
|
+
2. **Workspace ID**: Your workspace slug from the URL (e.g., `my-team`)
|
|
33
|
+
3. **Project ID**: The UUID from your project URL
|
|
34
|
+
|
|
35
|
+
## Available Tools
|
|
36
|
+
|
|
37
|
+
### Canvas & Agent Tools
|
|
38
|
+
| Tool | Description |
|
|
39
|
+
|------|-------------|
|
|
40
|
+
| `aether_canvas_state` | Get current canvas nodes, edges, and status |
|
|
41
|
+
| `aether_add_agent` | Add an AI agent to the canvas |
|
|
42
|
+
| `aether_remove_node` | Remove a node from the canvas |
|
|
43
|
+
| `aether_connect_nodes` | Create connections between nodes |
|
|
44
|
+
| `aether_list_agents` | List available agent types |
|
|
45
|
+
| `aether_get_agent_context` | Get context for an agent |
|
|
46
|
+
|
|
47
|
+
### Generation Tools
|
|
48
|
+
| Tool | Description |
|
|
49
|
+
|------|-------------|
|
|
50
|
+
| `aether_trigger_generation` | Start AI generation for a node |
|
|
51
|
+
| `aether_get_artifacts` | List generated artifacts |
|
|
52
|
+
| `aether_get_artifact_content` | Get full artifact content |
|
|
53
|
+
| `aether_create_artifact` | Create a new artifact |
|
|
54
|
+
| `aether_extract_files` | Extract code files from artifact |
|
|
55
|
+
|
|
56
|
+
### GitHub Automation
|
|
57
|
+
| Tool | Description |
|
|
58
|
+
|------|-------------|
|
|
59
|
+
| `aether_automation_status` | Check what's ready to push |
|
|
60
|
+
| `aether_push_artifacts` | Push artifacts to GitHub (branch + commit + PR) |
|
|
61
|
+
| `aether_list_repositories` | List synced repositories |
|
|
62
|
+
| `aether_read_repo_file` | Read a file from a repository |
|
|
63
|
+
|
|
64
|
+
### Orchestra (Autonomous Development)
|
|
65
|
+
| Tool | Description |
|
|
66
|
+
|------|-------------|
|
|
67
|
+
| `aether_start_orchestra` | Start an orchestra session |
|
|
68
|
+
| `aether_set_orchestra_plan` | Set the development plan |
|
|
69
|
+
| `aether_orchestra_approve` | Approve and begin execution |
|
|
70
|
+
| `aether_orchestra_status` | Get current progress |
|
|
71
|
+
| `aether_orchestra_next` | Get next ready tasks |
|
|
72
|
+
| `aether_orchestra_trigger_task` | Execute a specific task |
|
|
73
|
+
| `aether_report_to_orchestrator` | Report task completion/blockers |
|
|
74
|
+
| `aether_orchestra_pause` | Pause execution |
|
|
75
|
+
| `aether_orchestra_resume` | Resume execution |
|
|
76
|
+
| `aether_complete_orchestra` | Complete the session |
|
|
77
|
+
|
|
78
|
+
### Project & Workspace
|
|
79
|
+
| Tool | Description |
|
|
80
|
+
|------|-------------|
|
|
81
|
+
| `aether_list_projects` | List your projects |
|
|
82
|
+
| `aether_list_workspaces` | List your workspaces |
|
|
83
|
+
| `aether_switch_project` | Switch active project |
|
|
84
|
+
|
|
85
|
+
### Canvas Folders
|
|
86
|
+
| Tool | Description |
|
|
87
|
+
|------|-------------|
|
|
88
|
+
| `aether_list_folders` | List folders in project |
|
|
89
|
+
| `aether_create_folder` | Create a new folder |
|
|
90
|
+
| `aether_delete_folder` | Delete a folder |
|
|
91
|
+
| `aether_add_file_to_folder` | Add file/artifact to folder |
|
|
92
|
+
|
|
93
|
+
### Utility
|
|
94
|
+
| Tool | Description |
|
|
95
|
+
|------|-------------|
|
|
96
|
+
| `aether_shell` | Execute shell commands locally |
|
|
97
|
+
|
|
98
|
+
## Management Commands
|
|
99
|
+
|
|
100
|
+
```bash
|
|
101
|
+
# Check MCP server status
|
|
102
|
+
/mcp
|
|
103
|
+
|
|
104
|
+
# List all MCP servers
|
|
105
|
+
claude mcp list
|
|
106
|
+
|
|
107
|
+
# Remove Aether MCP
|
|
108
|
+
claude mcp remove aether
|
|
109
|
+
|
|
110
|
+
# Update to latest version
|
|
111
|
+
claude mcp remove aether && claude mcp add ...
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
## Troubleshooting
|
|
115
|
+
|
|
116
|
+
### "Unauthorized" errors
|
|
117
|
+
- Check your API key is correct
|
|
118
|
+
- Ensure the workspace ID matches your workspace slug
|
|
119
|
+
- Verify the project ID is a valid UUID
|
|
120
|
+
|
|
121
|
+
### "Project not found" errors
|
|
122
|
+
- Confirm you have access to the project
|
|
123
|
+
- Check the project ID in the URL
|
|
124
|
+
|
|
125
|
+
### Windows-specific issues
|
|
126
|
+
- Always use `cmd /c` before `npx` commands
|
|
127
|
+
- Use `^` for line continuation instead of `\`
|
|
128
|
+
|
|
129
|
+
## Links
|
|
130
|
+
|
|
131
|
+
- [Aether App](https://www.aithr.ai)
|
|
132
|
+
- [Claude Code](https://claude.com/claude-code)
|
|
133
|
+
- [MCP Documentation](https://modelcontextprotocol.io)
|
|
134
|
+
|
|
135
|
+
## License
|
|
136
|
+
|
|
137
|
+
MIT
|