[CHORE]: Move Python server template to mcp-servers/templates/python

Open Beginner friendly

#29 opened on Aug 24, 2026 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty: 2/5
Estimated time: Half a day
Newbie friendliness: 78/100

Issue type: Refactor
Clarity: Clearly specified
Activity status: Active
Tech stack: python
Domain: documentation, tooling

Research direction

Compare the source at IBM/mcp-context-forge/mcp-servers/templates/python with the destination mcp-servers/templates/python, then copy the listed template files verbatim. Use cookiecutter to generate a project and verify that the generated project installs and runs cleanly. Update the README with the new home and scaffold instructions.

Written by the indexing model from the issue text.

Description

Summary

Move the Python MCP server cookiecutter template from the mcp-context-forge monorepo into this repository at mcp-servers/templates/python/, as part of the MCP server migration tracked in IBM/mcp-context-forge#6228.

What to move

Copy the contents of mcp-servers/templates/python/ from IBM/mcp-context-forge verbatim:

mcp-servers/templates/python/
├── cookiecutter.json
└── {{cookiecutter.project_slug}}/
    ├── Containerfile
    ├── Makefile
    ├── README.md
    ├── pyproject.toml
    ├── src/
    │   └── {{cookiecutter.package_name}}/
    │       ├── __init__.py
    │       └── server.py
    └── tests/
        └── test_server.py

Dependencies (as-is)

The template's pyproject.toml defaults to:

mcp>=1.0.0,<2
orjson>=3.11.5
pydantic>=2.5.0

The template is moved as-is. Version constraint alignment with the live servers is tracked separately (see sub-issues).

Acceptance criteria

Template lands at mcp-servers/templates/python/ in this repository
cookiecutter can generate a working project from the template
Generated project installs and runs cleanly
README updated to reflect new home and updated scaffold instructions

References

Parent issue: IBM/mcp-context-forge#6228
Source: https://github.com/IBM/mcp-context-forge/tree/main/mcp-servers/templates/python

Dominant language: Python
Stars: 1
Forks: 1
Avg merge: 4h 29m
Merged PRs (30d): 1

Contributor guide

Open the contributing guide

First steps

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

Similar issues

[BUG] GkeTpuCluster queries metadata.google.internal for MEGASCALE_SLICE_ID even when TPU_SKIP_MDS_QUERY is set Open

Difficulty 2/5 1-3 hours Newbie friendliness 88/100

jax-ml/jax#40854 · Opened Sep 22, 2026
[pcied] Honour PCIE_DETACH_INFO on platforms that are not smartswitches Open

Difficulty 2/5 1-3 hours Newbie friendliness 82/100

sonic-net/sonic-platform-daemons#900 · Opened Sep 21, 2026
MCP client has no httpx timeout, so the event stream fails after 5 seconds Open

Difficulty 2/5 1-3 hours Newbie friendliness 78/100

Azure/azure-functions-agents-runtime#228 · Opened Sep 21, 2026
feat(mcp): friendlier error when `run_cloud_sync` is called on a disabled connection Open

enhancement

Difficulty 2/5 1-3 hours Newbie friendliness 72/100

airbytehq/PyAirbyte#1205 · Opened Sep 21, 2026
pn7160: reader goes permanently deaf — post-read IRQ-low check fails reads that succeeded Open

Difficulty 2/5 1-3 hours Newbie friendliness 74/100

esphome/esphome#19452 · Opened Sep 21, 2026

More Python issues