Add repo to pip package

[lamaalrajih]

Also see #17 for changes!

This PR turns the repository into a clean, PEP 517-compliant package that can be installed with pip and uploaded to PyPI.

Key points

• PEP 621 metadata – Introduces pyproject.toml with build-system requirements, full project metadata, dependencies, CLI entry-point (kicad-mcp), and package-data patterns.
• Source & wheel build verified – python -m build succeeds; twine check passes; package installs from TestPyPI when combined with the main index.
• Public API surfaced – kicad_mcp/init.py now exposes metadata constants and high-level helpers via __all__, making from kicad_mcp import create_server possible.
• Distribution assets added
  • MANIFEST.in to include license, readme, prompts, resources, docs
  • .python-version (3.10) and extended .gitignore for build artifacts

Checklist

• Build passes locally (python -m build)
• twine check dist/* passes
• Uploaded to TestPyPI and installation verified

[mannie-exe]

Hi @lamaalrajih! I noticed this PR addresses packaging but doesn't seem to be complete yet. I encountered some critical issues that need to be solved for the packaging to work properly.

The main blockers I found:

1. Pydantic schema generation error - The server fails to start due to MCP.Image type lacking Pydantic v2 compatibility
2. Dependency resolution issues - Unpinned dependencies cause different behavior between pip and uv

My solution:

• Migrated to uv for better dependency management with lock file
• Fixed the Pydantic error by removing problematic return type annotations

Fork

Would you like me to create a separate PR or discuss here? Either way, I'm happy to help get the packaging finalized! The project is really valuable and deserves proper PyPI distribution.

EDIT

Some background on the MCP issue:

• PydanticSchemaGenerationError: Unable to generate pydantic-core schema for Image type modelcontextprotocol/python-sdk#1060
• Allow arbitrary types in model creation by updating config in create_model modelcontextprotocol/python-sdk#1132

---

Example MCP Configs

Local/Development

"kicad": {
  "command": "uv",
  "args": [
    "--directory",
    "/absolute/path/to/kicad-mcp-folder/", // NOT `main.py`
    "run",
    "main.py" // `main.py` here
  ],
  "env": {
    "KICAD_SEARCH_PATHS": "/absolute/path/to/eda-files"
  }
}

PyPi

"kicad": {
  "command": "uvx",
  "args": [
    "kicad-mcp"
  ],
  "env": {
    "KICAD_SEARCH_PATHS": "/absolute/path/to/eda-files"
  }
}

Git

"kicad": {
  "command": "uvx",
  "args": [
    "--from",
    "git+https://github.com/lamaalrajih/kicad-mcp@latest", // + tag/commit/branch
    "kicad-mcp" // PyPi tool name
  ],
  "env": {
    "KICAD_SEARCH_PATHS": "/absolute/path/to/eda-files"
  }
}

[lamaalrajih]

Hey @mannie-exe ! Thanks so much for doing all this work :)

Honestly, if you could open it in a separate PR, it would be great! It would also help close #16. I'll just close this PR once you have yours up.

Really appreciate all the help!