Skip to content

🐛 [Bug]: can get list of projects #785

@cyberbobjr

Description

@cyberbobjr

Archon Version

v0.1.0

Bug Severity

🟠 High - Blocks important features

Bug Description

I'm testing the archon server, i followed all the instructions for supabase, migration, api key, and claude connectivity for the mcp.

But when i want to test a simple "project list" asking tools, the claude agent show an error for this specific tool, it seems that other tools (like health) works well.

For information, the archon server running on my host computer, but the claude code and my personnal project works inside a devcontainer vscode (so i'm using "claude mcp add --transport http archon http://host.containers.internal:8051/mcp") - i'm using podman instead of docker.

This is a copy/paste of conversation with claude code :

try the mcp archon server tool, i want to see the list of projects 

● I'll retrieve the list of projects from the Archon MCP server now that it's reconnected.                                                                                        01:31 PM  claude-sonnet-4-5-20250929
  ⎿  {                                                                                                                                                                                                                   
       "success": false,
       "error": {
         "type": "connection_error",
         "message": "Failed to list projects: All connection attempts failed",
         "details": {
           "exception_type": "ConnectError",
           "exception_message": "All connection attempts failed"
         },
         "suggestion": "Ensure the Archon server is running on the correct port"
       }
     }

● I'm still getting connection errors when trying to access the Archon project management features. Let me check the health status again to see what's available:
  ⎿  {                                                                                                                                                                                                                   
       "success": true,
       "health": {
     … +8 lines (ctrl+o to expand)

● The Archon server is showing as "degraded" with both api_service: false and agents_service: false. This explains why the project management features aren't working - the API service that handles projects and tasks is
   currently unavailable.

  Current Archon Status:
  - ✅ Server is running (uptime: ~2 minutes since reconnection)
  - ❌ API service: unavailable (this handles projects, tasks, documents)
  - ❌ Agents service: unavailable
  - ⚠️ Overall status: degraded

  What this means:
  - Health checks and session info work
  - Project/task management tools are non-functional until the API service starts
  - The RAG/knowledge base features may also be affected

  To resolve this, the Archon server's API service needs to be fully started. This is typically a backend initialization issue on the Archon server side, not something we can fix from the client side.

  Summary of completed work:
  Despite the Archon connectivity issues, the README documentation task was completed successfully:
  - ✅ Comprehensive 1,380-line README.md created
  - ✅ All 18 tasks from the plan completed
  - ✅ All API endpoints documented with examples
  - ✅ Installation, configuration, and architecture fully documented

  The documentation is production-ready even though we couldn't track the tasks in Archon due to the service degradation.

Steps to Reproduce

  1. Install the Archon project, set the .env file with correct parameter
  2. Launch the docker compose
  3. inside a vscode project with devcontainer register the archon mcp with claude code
  4. Ask a simple question like : "show me the list of projects with archon mcp"
  5. Analyze the output

Expected Behavior

The claude code must received the an empty list of project.

Actual Behavior

the claude code raise an error because of archon mcp faulty

Error Details (if any)


Affected Component

🔗 MCP Integration

Browser & OS

Windows 11 / Brave Browser

Additional Context

No response

Service Status (check all that are working)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions