feat: initialize Python project structure

- Create pyproject.toml with project metadata
- Add dependencies: mcp, httpx, python-dotenv
- Set up src/gitea_mcp package structure with __init__.py files
- Create placeholder server.py for MCP server implementation
- Add tools subdirectory for future tool implementations
- Create tests directory structure
- Update .gitignore with comprehensive Python exclusions
- Add README.md with project overview

Uses modern src-layout with pyproject.toml (no setup.py).
Project is ready for MCP server implementation.

Closes #1

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

.gitignore

@@ -0,0 +1,43 @@
+# Environment files
+.env
+.env.local
+.env.*.local
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+.venv/
+venv/
+ENV/
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db

README.md

@@ -0,0 +1,40 @@
+# Gitea MCP Remote
+
+MCP server for Gitea API integration.
+
+## Overview
+
+This project provides a Model Context Protocol (MCP) server that enables AI assistants to interact with Gitea through its API.
+
+## Project Status
+
+Currently in initial development. Project structure has been initialized.
+
+## Requirements
+
+- Python >= 3.10
+- Gitea instance with API access
+
+## Installation
+
+```bash
+pip install -e .
+```
+
+## Development
+
+Install with development dependencies:
+
+```bash
+pip install -e ".[dev]"
+```
+
+Run tests:
+
+```bash
+pytest
+```
+
+## License
+
+MIT

pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "gitea-mcp-remote"
+version = "0.1.0"
+description = "MCP server for Gitea API integration"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [
+    { name = "Leo Miranda", email = "lmiranda@example.com" }
+]
+keywords = ["mcp", "gitea", "api", "server"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+
+dependencies = [
+    "mcp>=0.1.0",
+    "httpx>=0.24.0",
+    "python-dotenv>=1.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/lmiranda/gitea-mcp-remote"
+Repository = "https://github.com/lmiranda/gitea-mcp-remote"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]

src/gitea_mcp/__init__.py

@@ -0,0 +1,3 @@
+"""Gitea MCP Server - MCP server for Gitea API integration."""
+
+__version__ = "0.1.0"

src/gitea_mcp/server.py

@@ -0,0 +1,7 @@
+"""MCP server implementation for Gitea API integration.
+
+This module will contain the main MCP server implementation.
+"""
+
+# Placeholder for MCP server implementation
+# TODO: Implement MCP server in future issues

src/gitea_mcp/tools/__init__.py

@@ -0,0 +1 @@
+"""Gitea MCP tools package."""

tests/__init__.py

@@ -0,0 +1 @@
+"""Tests for Gitea MCP server."""