microsoft / microsoft/foundry-dev-tools

Issues with `python-weather` MCP Server Template quickstart

Open
#287 1 comment 0 reactions 1 assignee View on GitHub

@swatDong is already working on this.

Since Oct 21, 2025.

Dominant language
JavaScript
Stars
2.1k
Forks
260
Avg merge
42m
Merged PRs (30d)
29

Description

Overview

I came across three issues that made it difficult to get through the README tutorial. Repro below:

Repro

  1. Start by selecting the python-weather MCP Server Template. Start following the README.
Image
  1. Set up the environment using uv
  2. Attempt to "Debug in Agent Builder"
Image

First issue:

  • From Output: Error when calling MCP Server local-server-test_weather: SSE error: TypeError: fetch failed: connect ECONNREFUSED 127.0.0.1:3001, connect ECONNREFUSED ::1:3001
  • From Terminal: Executing task: python -m debugpy --listen 127.0.0.1:5678 src/init.py sse
    source /Users/szhang/mcpServers/test-123/test-weat/bin/bash: python: command not found

The command is not being run from my venv, so I modified the tasks.json:7 to reference the interpreter's python path:
"command": "${command:python.interpreterPath} -m debugpy --listen 127.0.0.1:5678 src/__init__.py sse",

Running "Debug in Agent Builder" now works:

Image
  1. Attempt to run the hyperlinked prompt.
Image

Second issue:

  • The MCP tool entry is removed, so the agent is no longer calling the local MCP tool...
Image
  1. Attempt to run "Debug in Agent Builder" again:

Third issue:

  • Run doesn't go through because an instance of the local MCP server is still running. The command that pops up isn't helpful:
Image

To resolve, I run the command: "Tasks: Run Task > Terminate all tasks" --> press "Cancel" for all popups.

Actually, every time I "Debug in Agent Builder" and then run the prompt, I get back into the second issue state.

  1. After terminating all tasks, attempt to run the hyperlinked prompt and then "Debug in Agent Builder"

This results in the E2E working! However, the Instructions get wiped... :/

Image

Additionally, slight nit, can we mention in the README that you have to run "Tasks: Run Task > Terminate all tasks" if you want to switch to "Debug in Inspector..."? Without doing so, you are blocked and you have to input "Select instance to terminate", which isn't helpful.

Another thing: if I open this experience from the "Create New MCP Server" option, I would expect the newly created local MCP server to show up in my AI Toolkit extension. Without that there today, I'm lost with how to add the server to my AI Toolkit environment. I guess I would add an entry to Users/{me}/.ait/mcp.json and ensure that the server is running locally.

Image

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.