elasticsearch-mcp-server 0.1.3__tar.gz → 1.0.0__tar.gz

elasticsearch_mcp_server-1.0.0/.github/workflows/pypi-publish.yaml

@@ -0,0 +1,41 @@
+# This workflow will upload a Python Package using Twine when a release is created
+# For more information see: https://help.github.com/en/actions/language-and-framework-guides/using-python-with-github-actions#publishing-to-package-registries
+
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+name: PyPI Publish
+
+on:
+  workflow_run:
+    workflows: ["Release"]
+    types:
+      - completed
+
+env:
+  UV_PUBLISH_TOKEN: '${{ secrets.PYPI_API_TOKEN }}'
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    if: ${{ github.event.workflow_run.conclusion == 'success' }}
+    steps:
+    - uses: actions/checkout@v2
+
+    - name: Set up Python
+      uses: actions/setup-python@v2
+      with:
+        python-version: '3.10.x'
+
+    - name: Install dependencies
+      run: |
+        python -m pip install uv
+        uv sync
+
+    - name: Build package
+      run: uv build
+
+    - name: Publish package
+      run: uv publish

elasticsearch_mcp_server-1.0.0/.github/workflows/release.yml

@@ -0,0 +1,42 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.x'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install git-cliff
+
+      - name: Get version from tag
+        id: get_version
+        run: echo "VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_ENV
+
+      - name: Generate changelog
+        run: |
+          git-cliff --output CHANGELOG.md --latest
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v1
+        with:
+          name: v${{ env.VERSION }}
+          body_path: CHANGELOG.md
+          draft: false
+          prerelease: false

elasticsearch_mcp_server-1.0.0/Makefile

@@ -0,0 +1,18 @@
+.PHONY: release
+
+release:
+	@if [ -z "$(version)" ]; then \
+		echo "Please specify version: e.g, make release version=v0.0.6"; \
+		exit 1; \
+	fi
+	@echo "Updating version to $(version:v%=%)"
+	@python -c 'import tomli; import tomli_w; \
+		data = tomli.load(open("pyproject.toml", "rb")); \
+		data["project"]["version"] = "$(version:v%=%)"; \
+		tomli_w.dump(data, open("pyproject.toml", "wb"))'
+	@git add pyproject.toml
+	@git commit -m "release: update version to $(version:v%=%)"
+	@git push origin main
+	@git tag $(version)
+	@git push origin $(version)
+	@echo "Version updated and tag pushed. GitHub Actions will handle the release."

{elasticsearch_mcp_server-0.1.3 → elasticsearch_mcp_server-1.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: elasticsearch-mcp-server
-Version: 0.1.3
+Version: 1.0.0
 Summary: MCP Server for interacting with Elasticsearch
 License:                                  Apache License
                                    Version 2.0, January 2004
@@ -255,7 +255,33 @@ You can access Kibana from http://localhost:5601.
 
 ## Usage with Claude Desktop
 
-1. Add the following configuration to Claude Desktop's config file `claude_desktop_config.json`:
+Add the following configuration to Claude Desktop's config file `claude_desktop_config.json`.
+
+### Option 1: Using uvx (Recommended)
+
+Using `uvx` will automatically install the package from PyPI, no need to clone the repository locally
+
+```json
+{
+  "mcpServers": {
+    "elasticsearch-mcp-server": {
+      "command": "uvx",
+      "args": [
+        "elasticsearch-mcp-server"
+      ],
+      "env": {
+        "ELASTIC_HOST": "https://localhost:9200",
+        "ELASTIC_USERNAME": "elastic",
+        "ELASTIC_PASSWORD": "test123"
+      }
+    }
+  }
+}
+```
+
+### Option 2: Using uv with local development
+
+Using `uv` requires cloning the repository locally and specifying the path to the source code.
 
 ```json
 {
@@ -264,14 +290,14 @@ You can access Kibana from http://localhost:5601.
       "command": "uv",
       "args": [
         "--directory",
-        "path/to/elasticsearch_mcp_server/src",
+        "path/to/src/elasticsearch_mcp_server",
         "run",
-        "server.py"
+        "elasticsearch-mcp-server"
       ],
       "env": {
-        "ELASTIC_HOST": "<your_elastic_url>",
-        "ELASTIC_USERNAME": "<your_elastic_username>",
-        "ELASTIC_PASSWORD": "<your_elastic_password>>"
+        "ELASTIC_HOST": "https://localhost:9200",
+        "ELASTIC_USERNAME": "elastic",
+        "ELASTIC_PASSWORD": "test123"
       }
     }
   }
@@ -281,7 +307,7 @@ You can access Kibana from http://localhost:5601.
 - On macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
 - On Windows: `%APPDATA%/Claude/claude_desktop_config.json`
 
-3. Restart Claude Desktop to load the new MCP server.
+Restart Claude Desktop to load the new MCP server.
 
 Now you can interact with your Elasticsearch cluster through Claude using natural language commands like:
 - "List all indices in the cluster"

{elasticsearch_mcp_server-0.1.3 → elasticsearch_mcp_server-1.0.0}/README.md

@@ -42,7 +42,33 @@ You can access Kibana from http://localhost:5601.
 
 ## Usage with Claude Desktop
 
-1. Add the following configuration to Claude Desktop's config file `claude_desktop_config.json`:
+Add the following configuration to Claude Desktop's config file `claude_desktop_config.json`.
+
+### Option 1: Using uvx (Recommended)
+
+Using `uvx` will automatically install the package from PyPI, no need to clone the repository locally
+
+```json
+{
+  "mcpServers": {
+    "elasticsearch-mcp-server": {
+      "command": "uvx",
+      "args": [
+        "elasticsearch-mcp-server"
+      ],
+      "env": {
+        "ELASTIC_HOST": "https://localhost:9200",
+        "ELASTIC_USERNAME": "elastic",
+        "ELASTIC_PASSWORD": "test123"
+      }
+    }
+  }
+}
+```
+
+### Option 2: Using uv with local development
+
+Using `uv` requires cloning the repository locally and specifying the path to the source code.
 
 ```json
 {
@@ -51,14 +77,14 @@ You can access Kibana from http://localhost:5601.
       "command": "uv",
       "args": [
         "--directory",
-        "path/to/elasticsearch_mcp_server/src",
+        "path/to/src/elasticsearch_mcp_server",
         "run",
-        "server.py"
+        "elasticsearch-mcp-server"
       ],
       "env": {
-        "ELASTIC_HOST": "<your_elastic_url>",
-        "ELASTIC_USERNAME": "<your_elastic_username>",
-        "ELASTIC_PASSWORD": "<your_elastic_password>>"
+        "ELASTIC_HOST": "https://localhost:9200",
+        "ELASTIC_USERNAME": "elastic",
+        "ELASTIC_PASSWORD": "test123"
       }
     }
   }
@@ -68,7 +94,7 @@ You can access Kibana from http://localhost:5601.
 - On macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
 - On Windows: `%APPDATA%/Claude/claude_desktop_config.json`
 
-3. Restart Claude Desktop to load the new MCP server.
+Restart Claude Desktop to load the new MCP server.
 
 Now you can interact with your Elasticsearch cluster through Claude using natural language commands like:
 - "List all indices in the cluster"

elasticsearch_mcp_server-1.0.0/cliff.toml

@@ -0,0 +1,100 @@
+# git-cliff ~ configuration file
+# https://git-cliff.org/docs/configuration
+
+[changelog]
+# template for the changelog header
+header = """
+# Changelog\n
+"""
+# template for the changelog body
+# https://keats.github.io/tera/docs/#introduction
+body = """
+{% if version %}\
+    {% if previous.version %}\
+        ## [{{ version | trim_start_matches(pat="v") }}]($REPO/compare/{{ previous.version }}..{{ version }}) - {{ timestamp | date(format="%Y-%m-%d") }}
+    {% else %}\
+        ## [{{ version | trim_start_matches(pat="v") }}] - {{ timestamp | date(format="%Y-%m-%d") }}
+    {% endif %}\
+{% else %}\
+    ## [unreleased]
+{% endif %}\
+{% for group, commits in commits | group_by(attribute="group") %}
+    ### {{ group | striptags | trim | upper_first }}
+    {% for commit in commits
+    | filter(attribute="scope")
+    | sort(attribute="scope") %}
+        - **({{commit.scope}})**{% if commit.breaking %} [**breaking**]{% endif %} \
+            {{ commit.message }} - ([{{ commit.id | truncate(length=7, end="") }}]($REPO/commit/{{ commit.id }})) - @{{ commit.author.name }}
+    {%- endfor -%}
+    {% raw %}\n{% endraw %}\
+    {%- for commit in commits %}
+        {%- if commit.scope -%}
+        {% else -%}
+            - {% if commit.breaking %} [**breaking**]{% endif %}\
+                {{ commit.message }} - ([{{ commit.id | truncate(length=7, end="") }}]($REPO/commit/{{ commit.id }})) - @{{ commit.author.name }}
+        {% endif -%}
+    {% endfor -%}
+{% endfor %}\n
+"""
+# template for the changelog footer
+footer = """
+<!-- generated by git-cliff -->
+"""
+# remove the leading and trailing whitespace from the templates
+trim = true
+# postprocessors
+postprocessors = [
+    { pattern = '\$REPO', replace = "https://github.com/cr7258/elasticsearch-mcp-server" }, # replace repository URL
+]
+
+[git]
+# parse the commits based on https://www.conventionalcommits.org
+conventional_commits = true
+# filter out the commits that are not conventional
+filter_unconventional = true
+# process each line of a commit as an individual commit
+split_commits = false
+# regex for preprocessing the commit messages
+commit_preprocessors = [
+    # { pattern = '\((\w+\s)?#([0-9]+)\)', replace = "([#${2}](https://github.com/cr7258/elasticsearch-mcp-server/issues/${2}))"}, # replace issue numbers
+]
+# regex for parsing and grouping commits
+commit_parsers = [
+  { message = "^feat", group = "<!-- 0 -->⛰️  Features" },
+  { message = "^fix", group = "<!-- 1 -->🐛 Bug Fixes" },
+  { message = "^doc", group = "<!-- 3 -->📚 Documentation" },
+  { message = "^perf", group = "<!-- 4 -->⚡ Performance" },
+  { message = "^refactor\\(clippy\\)", skip = true },
+  { message = "^refactor", group = "<!-- 2 -->🚜 Refactor" },
+  { message = "^style", group = "<!-- 5 -->🎨 Styling" },
+  { message = "^test", group = "<!-- 6 -->🧪 Testing" },
+  { message = "^chore\\(release\\): prepare for", skip = true },
+  { message = "^chore\\(deps.*\\)", skip = true },
+  { message = "^chore\\(pr\\)", skip = true },
+  { message = "^chore\\(pull\\)", skip = true },
+  { message = "^chore\\(npm\\).*yarn\\.lock", skip = true },
+  { message = "^chore|^ci", group = "<!-- 7 -->⚙️ Miscellaneous Tasks" },
+  { body = ".*security", group = "<!-- 8 -->🛡️ Security" },
+  { message = "^revert", group = "<!-- 9 -->◀️ Revert" },
+]
+
+# filter out the commits that are not matched by commit parsers
+filter_commits = false
+# sort the tags topologically
+topo_order = false
+# sort the commits inside sections by oldest/newest order
+sort_commits = "oldest"
+# regex for matching git tags
+tag_pattern = "^v[0-9]"
+# regex for skipping tags
+skip_tags = ""
+# regex for ignoring tags
+ignore_tags = ""
+# use tag date instead of commit date
+date_order = true
+# path to git binary
+git_path = "git"
+# whether to use relaxed or strict semver parsing
+relaxed_semver = true
+# only show the changes for the current version
+tag_range = true

{elasticsearch_mcp_server-0.1.3 → elasticsearch_mcp_server-1.0.0}/pyproject.toml

@@ -1,8 +1,7 @@
 [project]
 name = "elasticsearch-mcp-server"
-version = "0.1.3"
+version = "1.0.0"
 description = "MCP Server for interacting with Elasticsearch"
-license = { file = "LICENSE" }
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
@@ -12,9 +11,14 @@ dependencies = [
     "fastmcp>=0.4.0",
 ]
 
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
+[project.license]
+file = "LICENSE"
 
 [project.scripts]
 elasticsearch-mcp-server = "elasticsearch_mcp_server:main"
+
+[build-system]
+requires = [
+    "hatchling",
+]
+build-backend = "hatchling.build"

{elasticsearch_mcp_server-0.1.3 → elasticsearch_mcp_server-1.0.0}/.gitignore

@@ -1,5 +1,5 @@
-.vscode
 .idea
+.vscode
 .venv
 dist
 __pycache__