Skip to content

[Bug] Windows/Codex: search_skills hangs after MCP tool discovery #116

Description

@EinzbernLi

Summary

On Windows with Codex using OpenSpace through stdio MCP, MCP initialization and tool discovery succeed, but search_skills never returns.

This is related to #36 but more specific: all OpenSpace tools are already visible before the local search call blocks.

Environment

  • Windows; Python 3.12.5
  • OpenSpace current main, installed with pip install -e .
  • Codex desktop, stdio MCP
  • MCP runtime: mcp 1.29.0
  • No cloud/LLM credentials configured for this local-search test

pip install -e . initially selected mcp 2.0.0, but OpenSpace imports mcp.server.fastmcp, which is absent in MCP 2. Installing mcp<2 was required to start the server.

Reproduction

  1. Start openspace-mcp through a stdio MCP client with OPENSPACE_WORKSPACE set to a local ASCII checkout and OPENSPACE_HOST_SKILL_DIRS set to the host skills directory.
  2. Initialize the session and call list_tools.
  3. Call search_skills with query delegate task.

Actual result

  • Tool discovery succeeds and returns: cloud_auth_flow, cloud_browse_skills, execute_task, fix_skill, search_skills, upload_skill.
  • search_skills does not return within 240 seconds.
  • The same behavior remained after moving to an ASCII checkout path, granting the host write access for logs/runtime state, trying shell-only scope, and setting an ASCII session-storage directory.

Expected result

Local search should return results or an actionable error without waiting indefinitely. The host integration guide states local search_skills works without a cloud API key.

Notes

The host MCP configuration has tool_timeout_sec = 600 for long execute_task calls. This report is about the standalone local search_skills call. Sanitized logs are available on request.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions