commit 95ed3d81cf5053a468b39abfc8db9e92136e7862
Author: lmiranda <leobmiranda@gmail.com>
Date:   Tue Feb 3 14:56:34 2026 -0500

    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>

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..38414b4
--- /dev/null
+++ b/.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
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..174bd96
--- /dev/null
+++ b/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
diff --git a/pyproject.toml b/pyproject.toml
new file mode 100644
index 0000000..8c3d1e4
--- /dev/null
+++ b/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_*"]
diff --git a/src/gitea_mcp/__init__.py b/src/gitea_mcp/__init__.py
new file mode 100644
index 0000000..7a9bc41
--- /dev/null
+++ b/src/gitea_mcp/__init__.py
@@ -0,0 +1,3 @@
+"""Gitea MCP Server - MCP server for Gitea API integration."""
+
+__version__ = "0.1.0"
diff --git a/src/gitea_mcp/server.py b/src/gitea_mcp/server.py
new file mode 100644
index 0000000..b9afbbb
--- /dev/null
+++ b/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
diff --git a/src/gitea_mcp/tools/__init__.py b/src/gitea_mcp/tools/__init__.py
new file mode 100644
index 0000000..6052e3c
--- /dev/null
+++ b/src/gitea_mcp/tools/__init__.py
@@ -0,0 +1 @@
+"""Gitea MCP tools package."""
diff --git a/tests/__init__.py b/tests/__init__.py
new file mode 100644
index 0000000..f1a4707
--- /dev/null
+++ b/tests/__init__.py
@@ -0,0 +1 @@
+"""Tests for Gitea MCP server."""