Lint pull requests and add just recipe

Author: joedursun

.github/workflows/ci.yml

@@ -0,0 +1,36 @@
+name: Validate Code Quality
+
+permissions:
+  contents: read
+  pull-requests: write
+
+on:
+  pull_request:
+    branches:
+      - 'master'
+
+jobs:
+  lint:
+    name: Code Quality & Testing
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install UV
+        uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: "pyproject.toml"
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Run Ruff check
+        run: uv ruff check
+
+      - name: Run Ruff format
+        run: uv ruff format --check

.gitignore

@@ -5,6 +5,7 @@ build/
 dist/
 wheels/
 *.egg-info
+.ruff-cache/
 
 # Virtual environments
 .venv

README.md

@@ -9,7 +9,7 @@
 </a>
 <br>
 
-> [!IMPORTANT]  
+> [!IMPORTANT]
 > :test_tube: This project is experimental and could be subject to breaking changes.
 
 # Polygon.io MCP Server
@@ -65,7 +65,7 @@ You can also run `claude mcp add-from-claude-desktop` if the MCP server is insta
 ### Claude Desktop
 
 1. Follow the [Claude Desktop MCP installation instructions](https://modelcontextprotocol.io/quickstart/user) to complete the initial installation and find your configuration file.
-1. Use the following example as reference to add Polygon's MCP server. 
+1. Use the following example as reference to add Polygon's MCP server.
 Make sure you complete the various fields.
     1. Path find your path to `uvx`, run `which uvx` in your terminal.
     2. Replace `<your_api_key_here>` with your actual Polygon.io API key.
@@ -181,15 +181,25 @@ npx @modelcontextprotocol/inspector uv --directory /path/to/mcp_polygon run mcp_
 
 This will launch a browser interface where you can interact with your MCP server directly and see input/output for each tool.
 
+### Code Linting
+
+This project uses [just](https://github.com/casey/just) for common development tasks. To lint your code before submitting a PR:
+
+```bash
+just lint
+```
+
+This will run `ruff format` and `ruff check --fix` to automatically format your code and fix linting issues.
+
 ## Links
 - [Polygon.io Documentation](https://polygon.io/docs?utm_campaign=mcp&utm_medium=referral&utm_source=github)
 - [Model Context Protocol](https://modelcontextprotocol.io)
 - [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk)
 
 ## Contributing
-If you found a bug or have an idea for a new feature, please first discuss it with us by submitting a new issue. 
-We will respond to issues within at most 3 weeks. 
-We're also open to volunteers if you want to submit a PR for any open issues but please discuss it with us beforehand. 
+If you found a bug or have an idea for a new feature, please first discuss it with us by submitting a new issue.
+We will respond to issues within at most 3 weeks.
+We're also open to volunteers if you want to submit a PR for any open issues but please discuss it with us beforehand.
 PRs that aren't linked to an existing issue or discussed with us ahead of time will generally be declined.
 
 <!----------------------------------------------------------------------------->

justfile

@@ -0,0 +1,3 @@
+lint:
+    uv run ruff format
+    uv run ruff check --fix

pyproject.toml

@@ -16,5 +16,10 @@ email = "[email protected]"
 requires = [ "hatchling",]
 build-backend = "hatchling.build"
 
+[dependency-groups]
+dev = [
+    "ruff>=0.12.4",
+]
+
 [project.scripts]
 mcp_polygon = "mcp_polygon:run"