Troubleshooting

Error: import httpx: No module named ‘httpx’

This is likely due to the httpx package not being installed in the Python environment you’re using. 

To resolve this, run the command in step 1 below. If the error persists, try steps 2 and 3: 

1. uv sync
   
2. uv pip install httpx 
   
3. uv run python -m jpmc.mcp_for_api_documentation.server  
   

MCP tools do not appear in GitHub Copilot

If you don't see MCP tool in your GitHub Copilot:

1. Open VS Code's Command Pallete:
   Cmd + Shift + P
2. In the Command Pallete, type and select  Developer: Reload Window to reload VS Code:
   
3. Check that: .vscode/mcp.json exists in your workspace
   
4. Check that the MCP server config is valid: 
   cat .vscode/mcp.json

MCP tool returns plain text instead of links

If the tool returns plain text instead of links to documentation:

1. Open VS Code's Command Pallete:
   Cmd + Shift + P
2. In the Command Pallete, type and select: Developer: Reload Window to reload VS Code
   
3. Start the MCP server
   
4. Confirm the MCP server (jpm-pdp) is available and running : 
   Cmd + Shift + P
   Type and select: MCP: List Servers
   
5. Run your request again  
   

Missing dependencies

If dependencies are missing: 

1. Run uv sync 

2. Then uv pip list This helps you verify that the virtual environment contains project dependencies. At a minimum you should see: jpmc-mcp-for-api-documentation, mcp and httpx.