[{"_1":2,"_373":-5,"_374":-5},"loaderData",{"_3":4,"_29":30,"_280":281},"root",{"_5":6,"_14":15},"toasts",[7],{"_8":9,"_10":11,"_12":13},"uid","0199a162-69f6-77ad-8b18-e555fe7b63d7","title","This MCP server does not support inspection","type","error","visitor",{"_16":17,"_18":19},"viewportWidth",1280,"visitorSession",{"_20":21,"_23":24,"_25":-5,"_26":27,"_28":-5},"attributes",[22],"bot","id",17365307,"membership","referenceId","0199a0f5-80f3-75d9-86a5-0e41e3be6810","userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_31":32,"_86":-5,"_87":45,"_34":88,"_197":198,"_279":180},"availableLocales",[33,45,51,58,65,72,79],{"_34":35,"_38":42,"_43":44},"mcpServer",{"_36":37,"_38":39,"_40":41},"description","Stellt eine Verbindung zu Jira-Instanzen her, um wöchentliche Berichte basierend auf der Problemaktivität zu generieren und unterstützt benutzerdefinierte JQL-Abfragen und optionale LLM-Zusammenfassung.","name","Jira Weekly Reporter MCP Server","readme","# Jira Weekly Reporter MCP Server\n\n[![Python-Version](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/) [![Lizenz: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nDieses Projekt stellt einen [FastMCP](https://gofastmcp.com/) -Server bereit, der sich mit Ihrer Jira-Instanz (Cloud oder Server/Rechenzentrum) verbindet, um wöchentliche Berichte basierend auf der Problemaktivität zu erstellen. Es nutzt die `pycontribs-jira` Bibliothek für die Jira-Interaktion und kann optional das Large Language Model (LLM) des verbundenen Clients zur Zusammenfassung des generierten Berichts verwenden.\n\n## ✨ Funktionen\n\n* **Jira-Verbindung:** Stellt eine sichere Verbindung zu Jira mithilfe von API-Token her, die in einer `.env` Datei gespeichert sind.\n* **MCP-Tool:** Stellt ein `generate_jira_report` -Tool bereit, auf das über das Model Context Protocol zugegriffen werden kann.\n* **Flexibles Reporting:**\n\n * Standardmäßig werden Probleme gemeldet, die in den letzten 7 Tagen aktualisiert wurden.\n * Ermöglicht die Angabe einer benutzerdefinierten JQL-Abfrage.\n * Kann Berichte nach einem bestimmten Jira-Projektschlüssel filtern.\n * Begrenzt die Anzahl der zurückgegebenen Ergebnisse (konfigurierbar).\n* **(Optional) LLM-Zusammenfassung:** Kann das LLM *des Clients* (über `ctx.sample()` ) verwenden, um eine prägnante Zusammenfassung des Berichts bereitzustellen.\n* **Asynchrone Handhabung:** Behandelt synchrone Jira-Bibliotheksaufrufe innerhalb des asynchronen FastMCP-Servers ordnungsgemäß mithilfe von `asyncio.to_thread` .\n\n## 📋 Voraussetzungen\n\n* Python 3.10 oder höher.\n* [`uv`](https://docs.astral.sh/uv/getting-started/installation/) (empfohlen) oder `pip` für die Paketverwaltung.\n* Zugriff auf eine Jira-Instanz (Cloud, Server oder Rechenzentrum).\n* Ein Jira-API-Token (persönliches Zugriffstoken für Server/DC).\n* [FastMCP CLI](https://gofastmcp.com/getting-started/installation) ist installiert und im PATH Ihres Systems verfügbar.\n\n## ⚙️ Einrichtung\n\n1. **Klonen Sie das Repository (falls zutreffend):**\n\n ```bash\n git clone https://github.com/Jongryong/jira_reporter.git\n cd jira_reporter\n ```\n\n2. **Abhängigkeiten installieren:** Wir empfehlen die Verwendung von `uv` :\n\n ```bash\n uv pip install fastmcp \"jira[cli]\" python-dotenv httpx anyio\n ```\n\n Alternativ können Sie `pip` verwenden:\n\n ```bash\n pip install fastmcp \"jira[cli]\" python-dotenv httpx anyio\n ```\n\n3. **`.env` -Datei erstellen:** Erstellen Sie eine Datei mit dem Namen `.env` im *selben Verzeichnis* wie `jira_reporter_server.py` . Fügen Sie Ihre Jira-Verbindungsdaten hinzu:\n\n ```dotenv\n # .env\n JIRA_URL=https://your-domain.atlassian.net # Your Jira Cloud URL or Self-Hosted URL\n JIRA_USERNAME=your_email@example.com # Your Jira login email\n JIRA_API_TOKEN=your_api_token_or_pat # Your generated API Token or PAT\n ```\n\n * **Sicherheit:**\n\n * **Übergeben Sie Ihre `.env` Datei niemals der Versionskontrolle!** Fügen Sie `.env` zu Ihrer `.gitignore` Datei hinzu.\n * **Jira Cloud:** Generieren Sie ein API-Token aus Ihren Atlassian-Kontoeinstellungen: [API-Token verwalten](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/) .\n * **Jira Server/Data Center:** Generieren Sie ein persönliches Zugriffstoken (PAT) aus Ihren Jira-Benutzerprofileinstellungen: [Verwenden persönlicher Zugriffstoken](https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html) .\n\n## ▶️ Ausführen des Servers (Standalone)\n\nSie können den Server zu Test- oder anderen Zwecken unabhängig betreiben:\n\n1. **Direkt mit Python:**\n\n ```bash\n python jira_reporter_server.py\n ```\n\n2. **Verwenden der FastMCP-CLI:**\n\n ```bash\n fastmcp run jira_reporter_server.py\n ```\n\n So führen Sie es mit SSE aus (z. B. für den Fernzugriff):\n\n ```bash\n fastmcp run jira_reporter_server.py --transport sse --port 8001\n ```\n\n## 🖥️ Verwendung mit Claude Desktop\n\nSo stellen Sie diesen Server als Tool innerhalb der Claude Desktop-Anwendung zur Verfügung:\n\n1. **Voraussetzungen sicherstellen:** Stellen Sie sicher, dass `fastmcp` installiert und im PATH Ihres Systems zugänglich ist, da die folgende Konfiguration den Befehl `fastmcp` verwendet.\n\n2. **Suchen Sie die Claude-Konfigurationsdatei:** Suchen Sie die Datei `claude_desktop_config.json` . Der Speicherort hängt von Ihrem Betriebssystem ab:\n\n * **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n * **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json` (normalerweise `C:\\Users\\\\AppData\\Roaming\\Claude\\claude_desktop_config.json` )\n * **Linux:** `~/.config/Claude/claude_desktop_config.json` (oder `$XDG_CONFIG_HOME/Claude/` )\n\n3. **Bearbeiten Sie die Konfigurationsdatei:** Öffnen Sie `claude_desktop_config.json` in einem Texteditor.\n\n4. **Serverkonfiguration hinzufügen:** Suchen Sie das Objekt `\"mcpServers\"` im JSON-Code (falls es nicht existiert, erstellen Sie es als leeres Objekt `{}` ). Fügen Sie den folgenden Eintrag in `mcpServers` ein und ersetzen Sie dabei `\"path/to/your/jira_reporter_server.py\"` durch den **absoluten Pfad** zu Ihrem Skript:\n\n ```json\n {\n \"mcpServers\": {\n // ... other servers might be here ...\n\n \"jira_report\": {\n \"command\": \"fastmcp\",\n \"args\": [\n \"run\",\n \"/path/to/your/jira_reporter_server.py\" // <-- IMPORTANT: Use the full, absolute path here\n ]\n }\n\n // ... other servers might be here ...\n }\n // ... rest of your Claude config ...\n }\n ```\n\n * `\"jira_report\"` : Dies ist der interne Name, den Claude verwendet. Sie können ihn bei Bedarf ändern.\n * `\"command\": \"fastmcp\"` : Weist Claude an, das Befehlszeilentool `fastmcp` zu verwenden.\n * `\"args\": [...]` : Weist Claude an `fastmcp run /path/to/your/jira_reporter_server.py` auszuführen.\n\n5. **Speichern und neu starten:** Speichern Sie die Datei `claude_desktop_config.json` und starten Sie die Claude Desktop-Anwendung neu.\n\n6. **Rufen Sie das Tool auf:** Sie sollten das Tool nun in Claude verwenden können, indem Sie den im Python-Skript ( `Jira Weekly Reporter` ) definierten Servernamen angeben. Beispiel: `@Jira Weekly Reporter generate jira report for project MYPROJ and summarize it`\n\n## 🛠️ Details zum MCP-Tool\n\n* **Toolname:** `generate_jira_report`\n* **Beschreibung:** Generiert einen Bericht über Jira-Probleme basierend auf einer JQL-Abfrage (standardmäßig mit den zuletzt aktualisierten Problemen). Optional kann der Bericht mithilfe des LLM des Clients zusammengefasst werden.\n\n**Parameter:**\n\n| Parameter | Typ | Erforderlich | Standard | Beschreibung |\n| :------------ | :-------- | :----------- | :------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------- |\n| `jql_query` | `string` | NEIN | `updated >= -7d ORDER BY updated DESC` | Optionale JQL-Abfrage. Wenn diese weggelassen wird, wird die Standardabfrage verwendet. |\n| `project_key` | `string` | NEIN | `None` | Optionaler Jira-Projektschlüssel (z. B. „PROJ“) zum Einschränken des Suchumfangs (hinzugefügt als `project = 'KEY' AND ...` ). |\n| `max_results` | `integer` | NEIN | `50` | Maximale Anzahl von Problemen, die in die Rohdaten des Berichts aufgenommen werden sollen. |\n| `summarize` | `boolean` | NEIN | `false` | Wenn `true` , fordert der Server über `ctx.sample()` eine Zusammenfassung vom LLM *des Clients* an. |\n\n## 📦 Serverabhängigkeiten\n\nDer `FastMCP` Konstruktor enthält `dependencies=[\"jira\"]` . Dies teilt Tools wie `fastmcp install` mit, dass die `jira` -Bibliothek für die korrekte Funktion dieses Servers beim Erstellen isolierter Umgebungen erforderlich ist.\n\n## 🤝 Beitragen\n\nBeiträge sind willkommen! Bitte senden Sie uns gerne Probleme oder Pull Requests.\n\n## 📄 Lizenz\n\nMIT-Lizenz","German","tag","de-DE",{"_34":46,"_38":49,"_43":50},{"_36":47,"_38":39,"_40":48},"Connects to Jira instances to generate weekly reports based on issue activity, supporting custom JQL queries and optional LLM summarization.","# Jira Weekly Reporter MCP Server\n\n[![Python Version](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) \n\nThis project provides a [FastMCP](https://gofastmcp.com/) server that connects to your Jira instance (Cloud or Server/Data Center) to generate weekly reports based on issue activity. It leverages the `pycontribs-jira` library for Jira interaction and can optionally use the connected client's Large Language Model (LLM) for summarizing the generated report.\n\n## ✨ Features\n\n* **Jira Connection:** Securely connects to Jira using API tokens stored in a `.env` file.\n* **MCP Tool:** Exposes a `generate_jira_report` tool accessible via the Model Context Protocol.\n* **Flexible Reporting:**\n * Defaults to reporting issues updated in the last 7 days.\n * Allows specifying a custom JQL query.\n * Can filter reports by a specific Jira project key.\n * Limits the number of results returned (configurable).\n* **(Optional) LLM Summarization:** Can use the *client's* LLM (via `ctx.sample()`) to provide a concise summary of the report.\n* **Asynchronous Handling:** Properly handles synchronous Jira library calls within the asynchronous FastMCP server using `asyncio.to_thread`.\n\n## 📋 Prerequisites\n\n* Python 3.10 or later.\n* [`uv`](https://docs.astral.sh/uv/getting-started/installation/) (recommended) or `pip` for package management.\n* Access to a Jira instance (Cloud, Server, or Data Center).\n* A Jira API Token (Personal Access Token for Server/DC).\n* [FastMCP CLI](https://gofastmcp.com/getting-started/installation) installed and available in your system's PATH.\n\n## ⚙️ Setup\n\n1. **Clone the Repository (if applicable):**\n ```bash\n git clone https://github.com/Jongryong/jira_reporter.git\n cd jira_reporter\n ```\n\n2. **Install Dependencies:**\n We recommend using `uv`:\n ```bash\n uv pip install fastmcp \"jira[cli]\" python-dotenv httpx anyio\n ```\n Alternatively, use `pip`:\n ```bash\n pip install fastmcp \"jira[cli]\" python-dotenv httpx anyio\n ```\n\n3. **Create `.env` File:**\n Create a file named `.env` in the *same directory* as `jira_reporter_server.py`. Add your Jira connection details:\n ```dotenv\n # .env\n JIRA_URL=https://your-domain.atlassian.net # Your Jira Cloud URL or Self-Hosted URL\n JIRA_USERNAME=your_email@example.com # Your Jira login email\n JIRA_API_TOKEN=your_api_token_or_pat # Your generated API Token or PAT\n ```\n * **Security:**\n * **Never commit your `.env` file to version control!** Add `.env` to your `.gitignore` file.\n * **Jira Cloud:** Generate an API token from your Atlassian account settings: [Manage API tokens](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/).\n * **Jira Server/Data Center:** Generate a Personal Access Token (PAT) from your Jira user profile settings: [Using Personal Access Tokens](https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html).\n\n## ▶️ Running the Server (Standalone)\n\nYou can run the server independently for testing or other purposes:\n\n1. **Directly with Python:**\n ```bash\n python jira_reporter_server.py\n ```\n\n2. **Using the FastMCP CLI:**\n ```bash\n fastmcp run jira_reporter_server.py\n ```\n To run with SSE (e.g., for remote access):\n ```bash\n fastmcp run jira_reporter_server.py --transport sse --port 8001\n ```\n\n## 🖥️ Using with Claude Desktop\n\nTo make this server available as a tool within the Claude Desktop application:\n\n1. **Ensure Prerequisites:** Make sure `fastmcp` is installed and accessible in your system's PATH, as the configuration below uses the `fastmcp` command.\n\n2. **Locate Claude Config File:** Find the `claude_desktop_config.json` file. Its location depends on your operating system:\n * **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n * **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json` (usually `C:\\Users\\\\AppData\\Roaming\\Claude\\claude_desktop_config.json`)\n * **Linux:** `~/.config/Claude/claude_desktop_config.json` (or `$XDG_CONFIG_HOME/Claude/`)\n\n3. **Edit the Config File:** Open `claude_desktop_config.json` in a text editor.\n\n4. **Add Server Configuration:** Find the `\"mcpServers\"` object within the JSON (if it doesn't exist, create it as an empty object `{}`). Add the following entry inside `mcpServers`, making sure to replace `\"path/to/your/jira_reporter_server.py\"` with the **absolute path** to your script:\n\n ```json\n {\n \"mcpServers\": {\n // ... other servers might be here ...\n\n \"jira_report\": {\n \"command\": \"fastmcp\",\n \"args\": [\n \"run\",\n \"/path/to/your/jira_reporter_server.py\" // <-- IMPORTANT: Use the full, absolute path here\n ]\n }\n\n // ... other servers might be here ...\n }\n // ... rest of your Claude config ...\n }\n ```\n * `\"jira_report\"`: This is the internal name Claude uses. You can change it if desired.\n * `\"command\": \"fastmcp\"`: Tells Claude to use the `fastmcp` command-line tool.\n * `\"args\": [...]`: Tells Claude to run `fastmcp run /path/to/your/jira_reporter_server.py`.\n\n5. **Save and Restart:** Save the `claude_desktop_config.json` file and restart the Claude Desktop application.\n\n6. **Invoke the Tool:** You should now be able to use the tool in Claude by mentioning the server name defined in the Python script (`Jira Weekly Reporter`). For example:\n `@Jira Weekly Reporter generate jira report for project MYPROJ and summarize it`\n\n## 🛠️ MCP Tool Details\n\n* **Tool Name:** `generate_jira_report`\n* **Description:** Generates a report of Jira issues based on a JQL query (defaulting to recently updated). Optionally summarizes the report using the client's LLM.\n\n**Parameters:**\n\n| Parameter | Type | Required | Default | Description |\n| :------------ | :----------- | :------- | :----------------------- | :------------------------------------------------------------------------------------------------------------- |\n| `jql_query` | `string` | No | `updated >= -7d ORDER BY updated DESC` | Optional JQL query. If omitted, the default is used. |\n| `project_key` | `string` | No | `None` | Optional Jira project key (e.g., \"PROJ\") to limit the search scope (added as `project = 'KEY' AND ...`). |\n| `max_results` | `integer` | No | `50` | Maximum number of issues to include in the raw report data. |\n| `summarize` | `boolean` | No | `false` | If `true`, the server will request a summary from the *client's* LLM via `ctx.sample()`. |\n\n## 📦 Server Dependencies\n\nThe `FastMCP` constructor includes `dependencies=[\"jira\"]`. This tells tools like `fastmcp install` that the `jira` library is required for this server to function correctly when creating isolated environments.\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit issues or pull requests.\n\n## 📄 License\n\nMIT License","English","en-US",{"_34":52,"_38":56,"_43":57},{"_36":53,"_38":54,"_40":55},"Se conecta a instancias de Jira para generar informes semanales basados en la actividad del problema, admitiendo consultas JQL personalizadas y resumen LLM opcional.","Servidor MCP de Jira Weekly Reporter","# Servidor MCP de Jira Weekly Reporter\n\n[![Versión de Python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/) [![Licencia: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nEste proyecto proporciona un servidor [FastMCP](https://gofastmcp.com/) que se conecta a su instancia de Jira (nube o servidor/centro de datos) para generar informes semanales basados en la actividad de incidencias. Utiliza la biblioteca `pycontribs-jira` para la interacción con Jira y, opcionalmente, puede usar el Modelo de Lenguaje Grande (LLM) del cliente conectado para resumir el informe generado.\n\n## ✨ Características\n\n* **Conexión Jira:** se conecta de forma segura a Jira mediante tokens API almacenados en un archivo `.env` .\n* **Herramienta MCP:** expone una herramienta `generate_jira_report` accesible a través del Protocolo de contexto de modelo.\n* **Informes flexibles:**\n\n * El valor predeterminado es informar problemas actualizados en los últimos 7 días.\n * Permite especificar una consulta JQL personalizada.\n * Puede filtrar informes por una clave de proyecto de Jira específica.\n * Limita el número de resultados devueltos (configurable).\n* **(Opcional) Resumen de LLM:** se puede utilizar el LLM *del cliente* (a través de `ctx.sample()` ) para proporcionar un resumen conciso del informe.\n* **Manejo asincrónico:** maneja adecuadamente las llamadas sincrónicas de la biblioteca Jira dentro del servidor FastMCP asincrónico usando `asyncio.to_thread` .\n\n## 📋 Requisitos previos\n\n* Python 3.10 o posterior.\n* [`uv`](https://docs.astral.sh/uv/getting-started/installation/) (recomendado) o `pip` para la gestión de paquetes.\n* Acceso a una instancia de Jira (nube, servidor o centro de datos).\n* Un token de API de Jira (token de acceso personal para servidor/DC).\n* [FastMCP CLI](https://gofastmcp.com/getting-started/installation) instalado y disponible en la RUTA de su sistema.\n\n## ⚙️ Configuración\n\n1. **Clonar el repositorio (si corresponde):**\n\n ```bash\n git clone https://github.com/Jongryong/jira_reporter.git\n cd jira_reporter\n ```\n\n2. **Instalar dependencias:** Recomendamos utilizar `uv` :\n\n ```bash\n uv pip install fastmcp \"jira[cli]\" python-dotenv httpx anyio\n ```\n\n Alternativamente, utilice `pip` :\n\n ```bash\n pip install fastmcp \"jira[cli]\" python-dotenv httpx anyio\n ```\n\n3. **Crear archivo `.env` :** Cree un archivo llamado `.env` en el *mismo directorio* que `jira_reporter_server.py` . Agregue los datos de su conexión de Jira:\n\n ```dotenv\n # .env\n JIRA_URL=https://your-domain.atlassian.net # Your Jira Cloud URL or Self-Hosted URL\n JIRA_USERNAME=your_email@example.com # Your Jira login email\n JIRA_API_TOKEN=your_api_token_or_pat # Your generated API Token or PAT\n ```\n\n * **Seguridad:**\n\n * **¡Nunca envíes tu archivo `.env` al control de versiones!** Agrega `.env` a tu archivo `.gitignore` .\n * **Jira Cloud:** genere un token de API desde la configuración de su cuenta de Atlassian: [Administrar tokens de API](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/) .\n * **Jira Server/Data Center:** Genere un token de acceso personal (PAT) a partir de la configuración de su perfil de usuario de Jira: [Uso de tokens de acceso personal](https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html) .\n\n## ▶️ Ejecución del servidor (independiente)\n\nPuede ejecutar el servidor de forma independiente para realizar pruebas u otros fines:\n\n1. **Directamente con Python:**\n\n ```bash\n python jira_reporter_server.py\n ```\n\n2. **Usando la CLI de FastMCP:**\n\n ```bash\n fastmcp run jira_reporter_server.py\n ```\n\n Para ejecutar con SSE (por ejemplo, para acceso remoto):\n\n ```bash\n fastmcp run jira_reporter_server.py --transport sse --port 8001\n ```\n\n## 🖥️ Uso con Claude Desktop\n\nPara que este servidor esté disponible como herramienta dentro de la aplicación Claude Desktop:\n\n1. **Asegúrese de cumplir con los requisitos previos:** asegúrese de que `fastmcp` esté instalado y accesible en la RUTA de su sistema, ya que la configuración a continuación utiliza el comando `fastmcp` .\n\n2. **Localizar el archivo de configuración de Claude:** Busca el archivo `claude_desktop_config.json` . Su ubicación depende del sistema operativo:\n\n * **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n * **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json` (normalmente `C:\\Users\\\\AppData\\Roaming\\Claude\\claude_desktop_config.json` )\n * **Linux:** `~/.config/Claude/claude_desktop_config.json` (o `$XDG_CONFIG_HOME/Claude/` )\n\n3. **Editar el archivo de configuración:** abra `claude_desktop_config.json` en un editor de texto.\n\n4. **Añadir la configuración del servidor:** Busca el objeto `\"mcpServers\"` en el JSON (si no existe, créalo como un objeto vacío `{}` ). Agrega la siguiente entrada dentro de `mcpServers` , asegurándote de reemplazar `\"path/to/your/jira_reporter_server.py\"` con la **ruta absoluta** a tu script:\n\n ```json\n {\n \"mcpServers\": {\n // ... other servers might be here ...\n\n \"jira_report\": {\n \"command\": \"fastmcp\",\n \"args\": [\n \"run\",\n \"/path/to/your/jira_reporter_server.py\" // <-- IMPORTANT: Use the full, absolute path here\n ]\n }\n\n // ... other servers might be here ...\n }\n // ... rest of your Claude config ...\n }\n ```\n\n * `\"jira_report\"` : Este es el nombre interno que usa Claude. Puedes cambiarlo si lo deseas.\n * `\"command\": \"fastmcp\"` : le dice a Claude que use la herramienta de línea de comandos `fastmcp` .\n * `\"args\": [...]` : Le dice a Claude que ejecute `fastmcp run /path/to/your/jira_reporter_server.py` .\n\n5. **Guardar y reiniciar:** guarde el archivo `claude_desktop_config.json` y reinicie la aplicación Claude Desktop.\n\n6. **Invocar la herramienta:** Ahora debería poder usar la herramienta en Claude mencionando el nombre del servidor definido en el script de Python ( `Jira Weekly Reporter` ). Por ejemplo: `@Jira Weekly Reporter generate jira report for project MYPROJ and summarize it`\n\n## 🛠️ Detalles de la herramienta MCP\n\n* **Nombre de la herramienta:** `generate_jira_report`\n* **Descripción:** Genera un informe de incidencias de Jira basado en una consulta JQL (el valor predeterminado es \"actualizado recientemente\"). Opcionalmente, resume el informe utilizando el LLM del cliente.\n\n**Parámetros:**\n\n| Parámetro | Tipo | Requerido | Por defecto | Descripción |\n| :------------ | :-------- | :-------- | :------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------- |\n| `jql_query` | `string` | No | `updated >= -7d ORDER BY updated DESC` | Consulta JQL opcional. Si se omite, se utiliza el valor predeterminado. |\n| `project_key` | `string` | No | `None` | Clave de proyecto Jira opcional (por ejemplo, \"PROJ\") para limitar el alcance de la búsqueda (agregada como `project = 'KEY' AND ...` ). |\n| `max_results` | `integer` | No | `50` | Número máximo de problemas a incluir en los datos del informe sin procesar. |\n| `summarize` | `boolean` | No | `false` | Si `true` , el servidor solicitará un resumen del LLM *del cliente* a través de `ctx.sample()` . |\n\n## Dependencias del servidor\n\nEl constructor `FastMCP` incluye `dependencies=[\"jira\"]` . Esto indica a herramientas como `fastmcp install` que la biblioteca `jira` es necesaria para que este servidor funcione correctamente al crear entornos aislados.\n\n## 🤝 Contribuyendo\n\n¡Agradecemos sus contribuciones! No dude en enviar incidencias o solicitudes de incorporación de cambios.\n\n## 📄 Licencia\n\nLicencia MIT","Spanish","es-ES",{"_34":59,"_38":63,"_43":64},{"_36":60,"_38":61,"_40":62},"Jira インスタンスに接続して、課題アクティビティに基づいて毎週レポートを生成し、カスタム JQL クエリとオプションの LLM 要約をサポートします。","Jira Weekly Reporter MCP サーバー","# Jira Weekly Reporter MCP サーバー\n\n[![Pythonバージョン](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/) [![ライセンス: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nこのプロジェクトは、Jiraインスタンス（クラウドまたはサーバー/データセンター）に接続し、課題のアクティビティに基づいて週次レポートを生成する[FastMCP](https://gofastmcp.com/)サーバーを提供します。Jiraとの連携には`pycontribs-jira`ライブラリを活用し、オプションで接続クライアントの大規模言語モデル（LLM）を使用して、生成されたレポートを要約することもできます。\n\n## ✨ 特徴\n\n* **Jira 接続:** `.env`ファイルに保存されている API トークンを使用して Jira に安全に接続します。\n* \\*\\*MCP ツール:\\*\\*モデルコンテキストプロトコル経由でアクセス可能な`generate_jira_report`ツールを公開します。\n* **柔軟なレポート:**\n\n * デフォルトでは、過去 7 日間に更新された問題が報告されます。\n * カスタム JQL クエリを指定できます。\n * 特定の Jira プロジェクトキーでレポートをフィルターできます。\n * 返される結果の数を制限します (構成可能)。\n* **(オプション) LLM 要約:** *クライアントの*LLM ( `ctx.sample()`経由) を使用して、レポートの簡潔な要約を提供できます。\n* **非同期処理:** `asyncio.to_thread`を使用して、非同期 FastMCP サーバー内で同期 Jira ライブラリ呼び出しを適切に処理します。\n\n## 📋 前提条件\n\n* Python 3.10 以降。\n* パッケージ管理には[`uv`](https://docs.astral.sh/uv/getting-started/installation/) (推奨) または`pip`します。\n* Jira インスタンス (クラウド、サーバー、またはデータセンター) へのアクセス。\n* Jira API トークン (サーバー/DC の個人アクセストークン)。\n* [FastMCP CLI](https://gofastmcp.com/getting-started/installation)がインストールされ、システムの PATH で利用可能になります。\n\n## ⚙️ セットアップ\n\n1. **リポジトリをクローンします (該当する場合)。**\n\n ```bash\n git clone https://github.com/Jongryong/jira_reporter.git\n cd jira_reporter\n ```\n\n2. **依存関係のインストール:** `uv`の使用をお勧めします:\n\n ```bash\n uv pip install fastmcp \"jira[cli]\" python-dotenv httpx anyio\n ```\n\n あるいは、 `pip`を使用します。\n\n ```bash\n pip install fastmcp \"jira[cli]\" python-dotenv httpx anyio\n ```\n\n3. **`.env`ファイルの作成:** `jira_reporter_server.py`と*同じディレクトリ*に`.env`という名前のファイルを作成します。Jira の接続情報を追加します。\n\n ```dotenv\n # .env\n JIRA_URL=https://your-domain.atlassian.net # Your Jira Cloud URL or Self-Hosted URL\n JIRA_USERNAME=your_email@example.com # Your Jira login email\n JIRA_API_TOKEN=your_api_token_or_pat # Your generated API Token or PAT\n ```\n\n * **安全：**\n\n * **`.env`ファイルをバージョン管理にコミットしないでください。.gitignore**ファイルに`.env``.gitignore`追加してください。\n * **Jira Cloud:** Atlassian アカウント設定から API トークンを生成します: [API トークンの管理](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/)。\n * **Jira Server/Data Center:** Jira ユーザープロファイル設定から個人アクセストークン (PAT) を生成します: [個人アクセストークンの使用](https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html)。\n\n## ▶️ サーバーの実行（スタンドアロン）\n\nテストやその他の目的のためにサーバーを独立して実行できます。\n\n1. **Python で直接:**\n\n ```bash\n python jira_reporter_server.py\n ```\n\n2. **FastMCP CLI の使用:**\n\n ```bash\n fastmcp run jira_reporter_server.py\n ```\n\n SSE で実行するには (例: リモートアクセス用):\n\n ```bash\n fastmcp run jira_reporter_server.py --transport sse --port 8001\n ```\n\n## 🖥️ Claude Desktop での使用\n\nこのサーバーを Claude Desktop アプリケーション内のツールとして使用できるようにするには、次の手順を実行します。\n\n1. \\*\\*前提条件の確認:\\*\\*以下の構成では`fastmcp`コマンドが使用されるため、 `fastmcp`がインストールされ、システムの PATH でアクセス可能であることを確認してください。\n\n2. **Claude Configファイルの場所：** `claude_desktop_config.json`ファイルを見つけます。ファイルの場所はオペレーティングシステムによって異なります。\n\n * **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n * **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json` (通常は`C:\\Users\\\\AppData\\Roaming\\Claude\\claude_desktop_config.json` )\n * **Linux:** `~/.config/Claude/claude_desktop_config.json` (または`$XDG_CONFIG_HOME/Claude/` )\n\n3. \\*\\*構成ファイルを編集します。\\*\\*テキストエディターで`claude_desktop_config.json`を開きます。\n\n4. **サーバー設定の追加:** JSONファイル内の`\"mcpServers\"`オブジェクトを探します（存在しない場合は、空のオブジェクト`{}`として作成します）。mcpServers 内に以下のエントリを追加します。 `\"path/to/your/jira_reporter_server.py\"``mcpServers`への**絶対パス**に置き換えてください。\n\n ```json\n {\n \"mcpServers\": {\n // ... other servers might be here ...\n\n \"jira_report\": {\n \"command\": \"fastmcp\",\n \"args\": [\n \"run\",\n \"/path/to/your/jira_reporter_server.py\" // <-- IMPORTANT: Use the full, absolute path here\n ]\n }\n\n // ... other servers might be here ...\n }\n // ... rest of your Claude config ...\n }\n ```\n\n * `\"jira_report\"` : これはClaudeが使用する内部名です。必要に応じて変更できます。\n * `\"command\": \"fastmcp\"` : Claude に`fastmcp`コマンドラインツールを使用するように指示します。\n * `\"args\": [...]` : Claude に`fastmcp run /path/to/your/jira_reporter_server.py`実行するように指示します。\n\n5. **保存して再起動:** `claude_desktop_config.json`ファイルを保存し、Claude Desktop アプリケーションを再起動します。\n\n6. **ツールの呼び出し：** Pythonスクリプトで定義されたサーバー名（ `Jira Weekly Reporter` ）を指定することで、Claudeでツールを使用できるようになります。例： `@Jira Weekly Reporter generate jira report for project MYPROJ and summarize it`\n\n## 🛠️ MCP ツールの詳細\n\n* **ツール名:** `generate_jira_report`\n* **説明:** JQLクエリに基づいてJiraの課題レポートを生成します（デフォルトは最近更新された課題）。オプションで、クライアントのLLMを使用してレポートを要約します。\n\n**パラメータ:**\n\n| パラメータ | タイプ | 必須 | デフォルト | 説明 |\n| :------------ | :-------- | :-- | :------------------------------------- | :----------------------------------------------------------------------------------- |\n| `jql_query` | `string` | いいえ | `updated >= -7d ORDER BY updated DESC` | オプションのJQLクエリ。省略した場合はデフォルトが使用されます。 |\n| `project_key` | `string` | いいえ | `None` | 検索範囲を制限するためのオプションの Jira プロジェクトキー (例: 「PROJ」) ( `project = 'KEY' AND ...`として追加されます)。 |\n| `max_results` | `integer` | いいえ | `50` | 生のレポートデータに含める問題の最大数。 |\n| `summarize` | `boolean` | いいえ | `false` | `true`場合、サーバーは`ctx.sample()`を介して*クライアントの*LLM からサマリーを要求します。 |\n\n## 📦 サーバーの依存関係\n\n`FastMCP`コンストラクタには`dependencies=[\"jira\"]`が含まれています。これは、 `fastmcp install`などのツールに、分離された環境を作成する際にこのサーバーが正しく機能するために`jira`ライブラリが必要であることを伝えます。\n\n## 🤝 貢献する\n\n貢献を歓迎します！問題やプルリクエストをお気軽にご提出ください。\n\n## 📄 ライセンス\n\nMITライセンス","Japanese","ja-JP",{"_34":66,"_38":70,"_43":71},{"_36":67,"_38":68,"_40":69},"Jira 인스턴스에 연결하여 이슈 활동에 따른 주간 보고서를 생성하고, 사용자 정의 JQL 쿼리와 선택적 LLM 요약을 지원합니다.","Jira 주간 리포터 MCP 서버","# Jira 주간 리포터 MCP 서버\n\n[![파이썬 버전](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/) [![라이센스: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n이 프로젝트는 Jira 인스턴스(클라우드 또는 서버/데이터 센터)에 연결하여 이슈 활동을 기반으로 주간 보고서를 생성하는 [FastMCP](https://gofastmcp.com/) 서버를 제공합니다. Jira와의 상호 작용을 위해 `pycontribs-jira` 라이브러리를 활용하며, 연결된 클라이언트의 LLM(Large Language Model)을 사용하여 생성된 보고서를 요약할 수도 있습니다.\n\n## ✨ 특징\n\n* **Jira 연결:** `.env` 파일에 저장된 API 토큰을 사용하여 Jira에 안전하게 연결합니다.\n* **MCP 도구:** 모델 컨텍스트 프로토콜을 통해 접근 가능한 `generate_jira_report` 도구를 제공합니다.\n* **유연한 보고:**\n\n * 지난 7일 동안 업데이트된 문제만 보고합니다.\n * 사용자 정의 JQL 쿼리를 지정할 수 있습니다.\n * 특정 Jira 프로젝트 키로 보고서를 필터링할 수 있습니다.\n * 반환되는 결과의 수를 제한합니다(구성 가능).\n* **(선택 사항) LLM 요약:** *클라이언트의* LLM( `ctx.sample()` 을 통해)을 사용하여 보고서에 대한 간결한 요약을 제공할 수 있습니다.\n* **비동기 처리:** `asyncio.to_thread` 사용하여 비동기 FastMCP 서버 내에서 동기 Jira 라이브러리 호출을 올바르게 처리합니다.\n\n## 📋 필수 조건\n\n* Python 3.10 이상.\n* 패키지 관리를 위해서는 [`uv`](https://docs.astral.sh/uv/getting-started/installation/) (권장) 또는 `pip` 합니다.\n* Jira 인스턴스(클라우드, 서버 또는 데이터 센터)에 액세스합니다.\n* Jira API 토큰(서버/DC용 개인 액세스 토큰).\n* [FastMCP CLI가](https://gofastmcp.com/getting-started/installation) 설치되어 시스템 PATH에 사용 가능합니다.\n\n## ⚙️ 설정\n\n1. **저장소를 복제합니다(해당되는 경우):**\n\n 지엑스피1\n\n2. **종속성 설치:** `uv` 사용하는 것이 좋습니다.\n\n ```bash\n uv pip install fastmcp \"jira[cli]\" python-dotenv httpx anyio\n ```\n\n 또는 `pip` 사용하세요:\n\n ```bash\n pip install fastmcp \"jira[cli]\" python-dotenv httpx anyio\n ```\n\n3. **`.env` 파일 만들기:** `jira_reporter_server.py` 와 *같은 디렉터리* 에 `.env` 라는 이름의 파일을 만듭니다. Jira 연결 정보를 추가합니다.\n\n ```dotenv\n # .env\n JIRA_URL=https://your-domain.atlassian.net # Your Jira Cloud URL or Self-Hosted URL\n JIRA_USERNAME=your_email@example.com # Your Jira login email\n JIRA_API_TOKEN=your_api_token_or_pat # Your generated API Token or PAT\n ```\n\n * **보안:**\n\n * **`.env` 파일을 버전 관리 시스템에 커밋하지 마세요!** `.gitignore` 파일에 `.env` 추가하세요.\n * **Jira Cloud:** Atlassian 계정 설정에서 API 토큰을 생성합니다. [API 토큰을 관리합니다](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/) .\n * **Jira 서버/데이터 센터:** Jira 사용자 프로필 설정에서 개인 액세스 토큰(PAT)을 생성합니다. [개인 액세스 토큰 사용](https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html) .\n\n## ▶️ 서버 실행(독립형)\n\n테스트나 다른 목적으로 서버를 독립적으로 실행할 수 있습니다.\n\n1. **Python을 사용하여 직접:**\n\n ```bash\n python jira_reporter_server.py\n ```\n\n2. **FastMCP CLI 사용:**\n\n ```bash\n fastmcp run jira_reporter_server.py\n ```\n\n SSE로 실행하려면(예: 원격 액세스의 경우):\n\n ```bash\n fastmcp run jira_reporter_server.py --transport sse --port 8001\n ```\n\n## 🖥️ Claude Desktop과 함께 사용\n\nClaude Desktop 애플리케이션 내에서 이 서버를 도구로 사용하려면:\n\n1. **필수 구성 요소 확인:** 아래 구성에서는 `fastmcp` 명령을 사용하므로 `fastmcp` 설치되어 있고 시스템의 PATH에서 액세스할 수 있는지 확인하세요.\n\n2. **Claude 구성 파일 찾기:** `claude_desktop_config.json` 파일을 찾으세요. 위치는 운영 체제에 따라 다릅니다.\n\n * **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n * **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json` (일반적으로 `C:\\Users\\\\AppData\\Roaming\\Claude\\claude_desktop_config.json` )\n * **Linux:** `~/.config/Claude/claude_desktop_config.json` (또는 `$XDG_CONFIG_HOME/Claude/` )\n\n3. **구성 파일 편집:** 텍스트 편집기에서 `claude_desktop_config.json` 엽니다.\n\n4. **서버 구성 추가:** JSON 파일에서 `\"mcpServers\"` 객체를 찾습니다(존재하지 않으면 빈 객체 `{}` 로 생성합니다). `mcpServers` 파일에 다음 항목을 추가하고, `\"path/to/your/jira_reporter_server.py\"` 스크립트의 **절대 경로** 로 변경하세요.\n\n ```json\n {\n \"mcpServers\": {\n // ... other servers might be here ...\n\n \"jira_report\": {\n \"command\": \"fastmcp\",\n \"args\": [\n \"run\",\n \"/path/to/your/jira_reporter_server.py\" // <-- IMPORTANT: Use the full, absolute path here\n ]\n }\n\n // ... other servers might be here ...\n }\n // ... rest of your Claude config ...\n }\n ```\n\n * `\"jira_report\"` : Claude가 사용하는 내부 이름입니다. 원하는 경우 변경할 수 있습니다.\n * `\"command\": \"fastmcp\"` : Claude에게 `fastmcp` 명령줄 도구를 사용하라고 알려줍니다.\n * `\"args\": [...]` : Claude에게 `fastmcp run /path/to/your/jira_reporter_server.py` 실행하라고 알려줍니다.\n\n5. **저장 및 다시 시작:** `claude_desktop_config.json` 파일을 저장하고 Claude Desktop 애플리케이션을 다시 시작합니다.\n\n6. **도구 호출:** 이제 Python 스크립트( `Jira Weekly Reporter` )에 정의된 서버 이름을 입력하여 Claude에서 도구를 사용할 수 있습니다. 예: `@Jira Weekly Reporter generate jira report for project MYPROJ and summarize it`\n\n## 🛠️ MCP 도구 세부 정보\n\n* **도구 이름:** `generate_jira_report`\n* **설명:** JQL 쿼리를 기반으로 Jira 이슈 보고서를 생성합니다(기본값은 최근 업데이트). 클라이언트의 LLM을 사용하여 보고서를 요약할 수도 있습니다.\n\n**매개변수:**\n\n| 매개변수 | 유형 | 필수의 | 기본 | 설명 |\n| :------------ | :-------- | :-- | :------------------------------------- | :--------------------------------------------------------------------------- |\n| `jql_query` | `string` | 아니요 | `updated >= -7d ORDER BY updated DESC` | 선택 사항인 JQL 쿼리입니다. 생략하면 기본값이 사용됩니다. |\n| `project_key` | `string` | 아니요 | `None` | 검색 범위를 제한하기 위한 선택적 Jira 프로젝트 키(예: \"PROJ\")( `project = 'KEY' AND ...` 로 추가됨). |\n| `max_results` | `integer` | 아니요 | `50` | 원시 보고서 데이터에 포함할 문제의 최대 개수입니다. |\n| `summarize` | `boolean` | 아니요 | `false` | `true` 경우 서버는 `ctx.sample()` 을 통해 *클라이언트의* LLM에 요약을 요청합니다. |\n\n## 📦 서버 종속성\n\n`FastMCP` 생성자에는 `dependencies=[\"jira\"]` 포함되어 있습니다. 이는 `fastmcp install` 과 같은 도구에 격리된 환경을 생성할 때 서버가 제대로 작동하려면 `jira` 라이브러리가 필요하다는 것을 알려줍니다.\n\n## 🤝 기여하기\n\n기여를 환영합니다! 이슈를 제출하거나 풀 리퀘스트를 보내주세요.\n\n## 📄 라이센스\n\nMIT 라이센스","Korean","ko-KR",{"_34":73,"_38":77,"_43":78},{"_36":74,"_38":75,"_40":76},"Подключается к экземплярам Jira для создания еженедельных отчетов на основе активности по задачам, поддерживает пользовательские запросы JQL и опциональное обобщение LLM.","Jira Weekly Reporter MCP-сервер","# Jira Weekly Reporter MCP-сервер\n\n[![Версия Python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/) [![Лицензия: Массачусетский технологический институт](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nЭтот проект предоставляет сервер [FastMCP](https://gofastmcp.com/) , который подключается к вашему экземпляру Jira (облако или сервер/центр обработки данных) для создания еженедельных отчетов на основе активности по проблемам. Он использует библиотеку `pycontribs-jira` для взаимодействия с Jira и может опционально использовать Large Language Model (LLM) подключенного клиента для резюмирования сгенерированного отчета.\n\n## ✨ Особенности\n\n* **Подключение к Jira:** безопасное подключение к Jira с использованием токенов API, хранящихся в файле `.env` .\n* **Инструмент MCP:** предоставляет инструмент `generate_jira_report` , доступный через протокол контекста модели.\n* **Гибкая отчетность:**\n\n * По умолчанию сообщения о проблемах обновляются за последние 7 дней.\n * Позволяет указать пользовательский JQL-запрос.\n * Возможность фильтровать отчеты по определенному ключу проекта Jira.\n * Ограничивает количество возвращаемых результатов (настраивается).\n* **(Необязательно) Резюме LLM:** можно использовать LLM *клиента* (через `ctx.sample()` ) для предоставления краткого резюме отчета.\n* **Асинхронная обработка:** правильно обрабатывает синхронные вызовы библиотеки Jira на асинхронном сервере FastMCP с помощью `asyncio.to_thread` .\n\n## 📋 Предварительные условия\n\n* Python 3.10 или более поздняя версия.\n* [`uv`](https://docs.astral.sh/uv/getting-started/installation/) (рекомендуется) или `pip` для управления пакетами.\n* Доступ к экземпляру Jira (облако, сервер или центр обработки данных).\n* Токен API Jira (персональный токен доступа для сервера/DC).\n* [FastMCP CLI](https://gofastmcp.com/getting-started/installation) установлен и доступен в PATH вашей системы.\n\n## ⚙️ Настройка\n\n1. **Клонируйте репозиторий (если применимо):**\n\n ```bash\n git clone https://github.com/Jongryong/jira_reporter.git\n cd jira_reporter\n ```\n\n2. **Установка зависимостей:** Мы рекомендуем использовать `uv` :\n\n ```bash\n uv pip install fastmcp \"jira[cli]\" python-dotenv httpx anyio\n ```\n\n В качестве альтернативы можно использовать `pip` :\n\n ```bash\n pip install fastmcp \"jira[cli]\" python-dotenv httpx anyio\n ```\n\n3. **Создайте файл `.env` :** Создайте файл с именем `.env` в *том же каталоге,* что и `jira_reporter_server.py` . Добавьте данные о подключении к Jira:\n\n ```dotenv\n # .env\n JIRA_URL=https://your-domain.atlassian.net # Your Jira Cloud URL or Self-Hosted URL\n JIRA_USERNAME=your_email@example.com # Your Jira login email\n JIRA_API_TOKEN=your_api_token_or_pat # Your generated API Token or PAT\n ```\n\n * **Безопасность:**\n\n * **Никогда не передавайте файл `.env` в систему контроля версий!** Добавьте `.env` в файл `.gitignore` .\n * **Jira Cloud:** создайте токен API из настроек вашего аккаунта Atlassian: [Управление токенами API](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/) .\n * **Сервер/центр обработки данных Jira:** создайте персональный токен доступа (PAT) из настроек профиля пользователя Jira: [Использование персональных токенов доступа](https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html) .\n\n## ▶️ Запуск сервера (автономный)\n\nВы можете запустить сервер независимо для тестирования или других целей:\n\n1. **Напрямую с помощью Python:**\n\n ```bash\n python jira_reporter_server.py\n ```\n\n2. **Использование FastMCP CLI:**\n\n ```bash\n fastmcp run jira_reporter_server.py\n ```\n\n Для запуска с SSE (например, для удаленного доступа):\n\n ```bash\n fastmcp run jira_reporter_server.py --transport sse --port 8001\n ```\n\n## 🖥️ Использование с Claude Desktop\n\nЧтобы сделать этот сервер доступным как инструмент в приложении Claude Desktop:\n\n1. **Убедитесь, что выполнены предварительные условия:** убедитесь, что `fastmcp` установлен и доступен в PATH вашей системы, так как в приведенной ниже конфигурации используется команда `fastmcp` .\n\n2. **Найдите файл конфигурации Claude:** Найдите файл `claude_desktop_config.json` . Его местоположение зависит от вашей операционной системы:\n\n * **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n * **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json` (обычно `C:\\Users\\\\AppData\\Roaming\\Claude\\claude_desktop_config.json` )\n * **Linux:** `~/.config/Claude/claude_desktop_config.json` (или `$XDG_CONFIG_HOME/Claude/` )\n\n3. **Отредактируйте файл конфигурации:** Откройте `claude_desktop_config.json` в текстовом редакторе.\n\n4. **Добавьте конфигурацию сервера:** найдите объект `\"mcpServers\"` в JSON (если он не существует, создайте его как пустой объект `{}` ). Добавьте следующую запись в `mcpServers` , обязательно заменив `\"path/to/your/jira_reporter_server.py\"` на **абсолютный путь** к вашему скрипту:\n\n ```json\n {\n \"mcpServers\": {\n // ... other servers might be here ...\n\n \"jira_report\": {\n \"command\": \"fastmcp\",\n \"args\": [\n \"run\",\n \"/path/to/your/jira_reporter_server.py\" // <-- IMPORTANT: Use the full, absolute path here\n ]\n }\n\n // ... other servers might be here ...\n }\n // ... rest of your Claude config ...\n }\n ```\n\n * `\"jira_report\"` : Это внутреннее имя, которое использует Клод. Вы можете изменить его, если хотите.\n * `\"command\": \"fastmcp\"` : сообщает Клоду, что нужно использовать инструмент командной строки `fastmcp` .\n * `\"args\": [...]` : сообщает Клоду о необходимости запустить `fastmcp run /path/to/your/jira_reporter_server.py` .\n\n5. **Сохраните и перезапустите:** сохраните файл `claude_desktop_config.json` и перезапустите приложение Claude Desktop.\n\n6. **Вызовите инструмент:** Теперь вы сможете использовать инструмент в Claude, упомянув имя сервера, определенное в скрипте Python ( `Jira Weekly Reporter` ). Например: `@Jira Weekly Reporter generate jira report for project MYPROJ and summarize it`\n\n## 🛠️ Подробности об инструменте MCP\n\n* **Название инструмента:** `generate_jira_report`\n* **Описание:** Формирует отчет о проблемах Jira на основе запроса JQL (по умолчанию — недавно обновленный). При желании суммирует отчет с использованием LLM клиента.\n\n**Параметры:**\n\n| Параметр | Тип | Необходимый | По умолчанию | Описание |\n| :------------ | :-------- | :---------- | :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- |\n| `jql_query` | `string` | Нет | `updated >= -7d ORDER BY updated DESC` | Необязательный запрос JQL. Если не указан, используется значение по умолчанию. |\n| `project_key` | `string` | Нет | `None` | Необязательный ключ проекта Jira (например, «PROJ») для ограничения области поиска (добавляется как `project = 'KEY' AND ...` ). |\n| `max_results` | `integer` | Нет | `50` | Максимальное количество проблем, включаемых в необработанные данные отчета. |\n| `summarize` | `boolean` | Нет | `false` | Если `true` , сервер запросит сводку из LLM *клиента* через `ctx.sample()` . |\n\n## 📦 Зависимости сервера\n\nКонструктор `FastMCP` включает `dependencies=[\"jira\"]` . Это сообщает таким инструментам, как `fastmcp install` , что библиотека `jira` необходима для корректной работы этого сервера при создании изолированных сред.\n\n## 🤝 Вклад\n\nВклады приветствуются! Пожалуйста, не стесняйтесь отправлять вопросы или запросы на включение.\n\n## 📄 Лицензия\n\nЛицензия Массачусетского технологического института","Russian","ru-RU",{"_34":80,"_38":84,"_43":85},{"_36":81,"_38":82,"_40":83},"连接到 Jira 实例以根据问题活动生成每周报告，支持自定义 JQL 查询和可选的 LLM 摘要。","Jira 每周报告 MCP 服务器","# Jira 每周报告 MCP 服务器\n\n[![Python 版本](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/) [![许可证：MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n该项目提供了一个[FastMCP](https://gofastmcp.com/)服务器，可连接到您的 Jira 实例（云或服务器/数据中心），并根据问题活动生成每周报告。它利用`pycontribs-jira`库与 Jira 进行交互，并可选择使用所连接客户端的大型语言模型 (LLM) 来汇总生成的报告。\n\n## ✨ 特点\n\n* \\*\\*Jira 连接：\\*\\*使用存储在`.env`文件中的 API 令牌安全地连接到 Jira。\n* \\*\\*MCP 工具：\\*\\*公开可通过模型上下文协议访问的`generate_jira_report`工具。\n* **灵活的报告：**\n\n * 默认报告过去 7 天内更新的问题。\n * 允许指定自定义 JQL 查询。\n * 可以按特定的 Jira 项目键过滤报告。\n * 限制返回的结果数量（可配置）。\n* \\*\\*（可选）LLM 摘要：\\*\\*可以使用*客户端的*LLM（通过`ctx.sample()` ）提供报告的简明摘要。\n* \\*\\*异步处理：\\*\\*使用`asyncio.to_thread`正确处理异步 FastMCP 服务器中的同步 Jira 库调用。\n\n## 📋 先决条件\n\n* Python 3.10 或更高版本。\n* [`uv`](https://docs.astral.sh/uv/getting-started/installation/) （推荐）或`pip`用于包管理。\n* 访问 Jira 实例（云、服务器或数据中心）。\n* Jira API 令牌（服务器/DC 的个人访问令牌）。\n* [FastMCP CLI](https://gofastmcp.com/getting-started/installation)已安装并在系统的 PATH 中可用。\n\n## ⚙️ 设置\n\n1. **克隆存储库（如果适用）：**\n\n ```bash\n git clone https://github.com/Jongryong/jira_reporter.git\n cd jira_reporter\n ```\n\n2. \\*\\*安装依赖项：\\*\\*我们建议使用`uv` ：\n\n ```bash\n uv pip install fastmcp \"jira[cli]\" python-dotenv httpx anyio\n ```\n\n 或者，使用`pip` ：\n\n ```bash\n pip install fastmcp \"jira[cli]\" python-dotenv httpx anyio\n ```\n\n3. \\*\\*创建`.env`文件：\\*\\*在与`jira_reporter_server.py`*相同的目录*中创建一个名为`.env`的文件。添加您的 Jira 连接详细信息：\n\n ```dotenv\n # .env\n JIRA_URL=https://your-domain.atlassian.net # Your Jira Cloud URL or Self-Hosted URL\n JIRA_USERNAME=your_email@example.com # Your Jira login email\n JIRA_API_TOKEN=your_api_token_or_pat # Your generated API Token or PAT\n ```\n\n * **安全：**\n\n * \\*\\*永远不要将`.env`文件提交到版本控制！\\*\\*请将`.env`添加到`.gitignore`文件中。\n * \\*\\*Jira Cloud：\\*\\*从您的 Atlassian 帐户设置生成 API 令牌： [管理 API 令牌](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/)。\n * \\*\\*Jira 服务器/数据中心：\\*\\*从您的 Jira 用户配置文件设置生成个人访问令牌 (PAT)： [使用个人访问令牌](https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html)。\n\n## ▶️ 运行服务器（独立）\n\n您可以独立运行服务器以进行测试或其他目的：\n\n1. **直接使用 Python：**\n\n ```bash\n python jira_reporter_server.py\n ```\n\n2. **使用 FastMCP CLI：**\n\n ```bash\n fastmcp run jira_reporter_server.py\n ```\n\n 要使用 SSE 运行（例如，用于远程访问）：\n\n ```bash\n fastmcp run jira_reporter_server.py --transport sse --port 8001\n ```\n\n## 🖥️ 与 Claude Desktop 一起使用\n\n要使此服务器作为 Claude Desktop 应用程序中的工具使用：\n\n1. \\*\\*确保先决条件：\\*\\*确保`fastmcp`已安装并可在系统 PATH 中访问，因为下面的配置使用`fastmcp`命令。\n\n2. \\*\\*找到 Claude 配置文件：\\*\\*找到`claude_desktop_config.json`文件。其位置取决于您的操作系统：\n\n * **macOS：** `~/Library/Application Support/Claude/claude_desktop_config.json`\n * **Windows：** `%APPDATA%\\Claude\\claude_desktop_config.json` （通常为`C:\\Users\\\\AppData\\Roaming\\Claude\\claude_desktop_config.json` ）\n * **Linux：** `~/.config/Claude/claude_desktop_config.json` （或`$XDG_CONFIG_HOME/Claude/` ）\n\n3. \\*\\*编辑配置文件：\\*\\*在文本编辑器中打开`claude_desktop_config.json` 。\n\n4. **添加服务器配置：**在 JSON 中找到`\"mcpServers\"`对象（如果不存在，请将其创建为空对象`{}` ）。在`mcpServers`中添加以下条目，并确保将`\"path/to/your/jira_reporter_server.py\"`替换为脚本的**绝对路径**：\n\n ```json\n {\n \"mcpServers\": {\n // ... other servers might be here ...\n\n \"jira_report\": {\n \"command\": \"fastmcp\",\n \"args\": [\n \"run\",\n \"/path/to/your/jira_reporter_server.py\" // <-- IMPORTANT: Use the full, absolute path here\n ]\n }\n\n // ... other servers might be here ...\n }\n // ... rest of your Claude config ...\n }\n ```\n\n * `\"jira_report\"` ：这是 Claude 使用的内部名称。您可以根据需要更改它。\n * `\"command\": \"fastmcp\"` ：告诉 Claude 使用`fastmcp`命令行工具。\n * `\"args\": [...]` ：告诉 Claude 运行`fastmcp run /path/to/your/jira_reporter_server.py` 。\n\n5. \\*\\*保存并重新启动：\\*\\*保存`claude_desktop_config.json`文件并重新启动 Claude Desktop 应用程序。\n\n6. \\*\\*调用工具：\\*\\*现在，您应该能够在 Claude 中通过提及 Python 脚本（ `Jira Weekly Reporter` ）中定义的服务器名称来使用该工具。例如： `@Jira Weekly Reporter generate jira report for project MYPROJ and summarize it`\n\n## 🛠️ MCP 工具详情\n\n* **工具名称：** `generate_jira_report`\n* \\*\\*描述：\\*\\*基于 JQL 查询生成 Jira 问题报告（默认为最近更新）。可选择使用客户端的 LLM 汇总报告。\n\n**参数：**\n\n| 范围 | 类型 | 必需的 | 默认 | 描述 |\n| :------------ | :-------- | :-- | :------------------------------------- | :------------------------------------------------------------- |\n| `jql_query` | `string` | 不 | `updated >= -7d ORDER BY updated DESC` | 可选的 JQL 查询。如果省略，则使用默认值。 |\n| `project_key` | `string` | 不 | `None` | 可选的 Jira 项目键（例如“PROJ”）用于限制搜索范围（添加为`project = 'KEY' AND ...` ）。 |\n| `max_results` | `integer` | 不 | `50` | 原始报告数据中包含的最大问题数。 |\n| `summarize` | `boolean` | 不 | `false` | 如果为`true` ，服务器将通过`ctx.sample()`向*客户端的*LLM 请求摘要。 |\n\n## 📦服务器依赖项\n\n`FastMCP`构造函数包含`dependencies=[\"jira\"]` 。这告诉`fastmcp install`之类的工具，在创建隔离环境时，此服务器需要`jira`库才能正常运行。\n\n## 🤝 贡献\n\n欢迎贡献！请随时提交问题或拉取请求。\n\n## 📄 许可证\n\nMIT 许可证","Chinese","zh-CN","githubUser","locale",{"_89":90,"_20":91,"_98":47,"_99":47,"_23":100,"_101":102,"_38":39,"_127":128,"_135":-5,"_136":-5,"_137":138,"_187":188,"_192":-5,"_109":171,"_193":175,"_8":194,"_195":196},"addedAt","2025-05-05T12:00:15.053718Z",[92,93,94,95,96,97],"category:monitoring","category:developer-tools","category:app-automation","hosting:local-only","language:python","license_grade:f","descriptionMarkdown","descriptionPlainText",6308,"integrations",[103,113,120],{"_104":105,"_36":111,"_8":112},"brand",{"_106":107,"_38":108,"_109":110},"logoSvgPath","M7.12 11.084a.683.683 0 00-1.16.126L.075 22.974a.703.703 0 00.63 1.018h8.19a.678.678 0 00.63-.39c1.767-3.65.696-9.203-2.406-12.52zM11.434.386a15.515 15.515 0 00-.906 15.317l3.95 7.9a.703.703 0 00.628.388h8.19a.703.703 0 00.63-1.017L12.63.38a.664.664 0 00-1.196.006z","Atlassian","slug","atlassian","Integrates with Atlassian's Jira platform to access issue data and generate activity reports using the Jira API.","pxhepkji1w",{"_104":114,"_36":118,"_8":119},{"_106":115,"_38":116,"_109":117},"M24 0v24H0V0h24ZM10.933 15.89H6.84v5.52h4.198v-.93H7.955v-1.503h2.77v-.93h-2.77v-1.224h2.978v-.934Zm2.146 0h-1.084v5.52h1.035v-3.6l2.226 3.6h1.118v-5.52h-1.036v3.686l-2.259-3.687Zm5.117 0h-1.208l1.973 5.52h1.19l1.976-5.52h-1.182l-1.352 4.085-1.397-4.086ZM5.4 19.68H3.72v1.68H5.4v-1.68Z",".ENV","dotenv","Uses .env files to securely store Jira connection credentials including API tokens for authentication.","clusyvuabt",{"_104":121,"_36":125,"_8":126},{"_106":122,"_38":123,"_109":124},"M11.571 11.513H0a5.218 5.218 0 0 0 5.232 5.215h2.13v2.057A5.215 5.215 0 0 0 12.575 24V12.518a1.005 1.005 0 0 0-1.005-1.005zm5.723-5.756H5.736a5.215 5.215 0 0 0 5.215 5.214h2.129v2.058a5.218 5.218 0 0 0 5.215 5.214V6.758a1.001 1.001 0 0 0-1.001-1.001zM23.013 0H11.455a5.215 5.215 0 0 0 5.215 5.215h2.129v2.057A5.215 5.215 0 0 0 24 12.483V1.005A1.001 1.001 0 0 0 23.013 0Z","Jira","jira","Connects to Jira Cloud or Server/Data Center to generate weekly reports based on issue activity. Supports custom JQL queries, project filtering, and result limiting.","r203qja2iv","namespace",{"_129":130,"_109":134},"owner",{"_131":132},"githubAccount",{"_133":134},"login","Jongryong","readmeMarkdown","redditPostExternalId","repository",{"_139":140,"_156":157,"_160":161,"_178":-5,"_179":180,"_181":-5,"_182":183},"argumentsJsonSchema",{"_141":142,"_153":154,"_12":155},"properties",{"_143":144,"_147":148,"_150":151},"JIRA_URL",{"_36":145,"_12":146},"Your Jira Cloud URL or Self-Hosted URL (e.g., https://your-domain.atlassian.net)","string","JIRA_USERNAME",{"_36":149,"_12":146},"Your Jira login email","JIRA_API_TOKEN",{"_36":152,"_12":146},"Your generated API Token or Personal Access Token (PAT)","required",[143,147,150],"object","githubProject",{"_40":48,"_158":159},"url","https://github.com/Jongryong/jira_reporter","githubRepository",{"_162":163,"_164":165,"_166":167,"_23":168,"_169":170,"_38":171,"_129":172,"_174":175,"_176":-5,"_177":175},"defaultBranch","main","fullName","Jongryong/jira_reporter","githubTreeId",359835,12370,"language","Python","jira_reporter",{"_133":134,"_8":173},"t81XGVEHyr","recentStargazers",0,"spdxLicense","stargazers","glamaJson","inspectable",false,"npmPackage","supportedPlatforms",[184,185,186],"WINDOWS","MACOS","LINUX","scores",{"_189":175,"_190":-5,"_191":-5},"license","quality","security","simpleIcon","toolCount","hbu6889p79","updatedAt","2025-10-01T15:43:28.710451Z","meta",[199,201,203,210,213,215,218,221,224,227,230,232,235,238,240,242,244,246,248],{"_10":200},"Jira Weekly Reporter MCP Server | Glama",{"_202":47,"_38":36},"content",{"_204":205,"_206":207,"_208":209},"href","https://glama.ai/mcp/servers/@Jongryong/jira_reporter","rel","canonical","tagName","link",{"_202":39,"_211":212},"property","og:title",{"_202":47,"_211":214},"og:description",{"_202":216,"_211":217},"https://glama.ai/logo.png","og:logo",{"_202":219,"_211":220},"https://glama.ai/mcp/servers/@Jongryong/jira_reporter/og-image","og:image",{"_202":222,"_211":223},"630","og:image:height",{"_202":225,"_211":226},"1200","og:image:width",{"_202":228,"_211":229},"website","og:type",{"_202":205,"_211":231},"og:url",{"_202":233,"_211":234},"Glama – MCP Hosting Platform","og:site_name",{"_202":236,"_38":237},"summary_large_image","twitter:card",{"_202":233,"_38":239},"twitter:title",{"_202":47,"_38":241},"twitter:description",{"_202":219,"_38":243},"twitter:image",{"_202":222,"_38":245},"twitter:image:height",{"_202":225,"_38":247},"twitter:image:width",{"_249":250},"script:ld+json",{"_251":252,"_253":254},"@context","http://schema.org","@graph",[255],{"_251":256,"_257":258,"_259":260},"https://schema.org","@type","BreadcrumbList","itemListElement",[261,268,272,276],{"_257":262,"_263":264,"_38":265,"_266":267},"ListItem","item","/","Glama","position",1,{"_257":262,"_263":269,"_38":270,"_266":271},"/mcp","MCP",2,{"_257":262,"_263":273,"_38":274,"_266":275},"/mcp/servers","Servers",3,{"_257":262,"_263":277,"_38":39,"_266":278},"/mcp/servers/@Jongryong/jira_reporter",4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~commit/~/_route",{"_282":283,"_34":289,"_313":314,"_197":326,"_323":350,"_351":352},"blob",{"_202":284,"_285":286,"_287":288},"version = 1\nrevision = 2\nrequires-python = \">=3.12\"\n\n[[package]]\nname = \"jira-reporter\"\nversion = \"0.1.0\"\nsource = { virtual = \".\" }\n","fileName","uv.lock","size",133,{"_89":90,"_20":290,"_98":47,"_99":47,"_23":100,"_101":291,"_38":39,"_127":298,"_135":-5,"_136":-5,"_137":301,"_187":312,"_192":-5,"_109":171,"_193":175,"_8":194,"_195":196},[92,93,94,95,96,97],[292,294,296],{"_104":293,"_36":111,"_8":112},{"_106":107,"_38":108,"_109":110},{"_104":295,"_36":118,"_8":119},{"_106":115,"_38":116,"_109":117},{"_104":297,"_36":125,"_8":126},{"_106":122,"_38":123,"_109":124},{"_129":299,"_109":134},{"_131":300},{"_133":134},{"_139":302,"_156":308,"_160":309,"_178":-5,"_179":180,"_181":-5,"_182":311},{"_141":303,"_153":307,"_12":155},{"_143":304,"_147":305,"_150":306},{"_36":145,"_12":146},{"_36":149,"_12":146},{"_36":152,"_12":146},[143,147,150],{"_40":48,"_158":159},{"_162":163,"_164":165,"_166":167,"_23":168,"_169":170,"_38":171,"_129":310,"_174":175,"_176":-5,"_177":175},{"_133":134,"_8":173},[184,185,186],{"_189":175,"_190":-5,"_191":-5},"member",{"_315":316,"_319":320,"_321":286,"_166":167,"_322":180,"_323":286,"_324":325,"_287":288,"_12":282},"commit",{"_317":318},"sha","74d4d90b95e4e5941e4c1ce980e00cc79ec448d7","contentStoredObjectPointerId",10411720,"fullPath","indexable","path","safeToDisplayAsText",true,[327,329,331,333,335,336,337,339,340,341,342,343,344,345,346,347,348,349],{"_10":328},"uv.lock | Jira Weekly Reporter MCP Server | Glama",{"_202":330,"_38":36},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_204":332,"_206":207,"_208":209},"https://glama.ai/mcp/servers/@Jongryong/jira_reporter/blob/74d4d90b95e4e5941e4c1ce980e00cc79ec448d7/",{"_202":334,"_211":212},"uv.lock | Jira Weekly Reporter MCP Server",{"_202":330,"_211":214},{"_202":216,"_211":217},{"_202":338,"_211":220},"https://glama.ai/generated-images/og?title=uv.lock+%7C+Jira+Weekly+Reporter+MCP+Server",{"_202":222,"_211":223},{"_202":225,"_211":226},{"_202":228,"_211":229},{"_202":332,"_211":231},{"_202":233,"_211":234},{"_202":236,"_38":237},{"_202":233,"_38":239},{"_202":330,"_38":241},{"_202":338,"_38":243},{"_202":222,"_38":245},{"_202":225,"_38":247},"","treeMembers",[353,356,359,362,365,368,371],{"_315":354,"_321":355,"_323":355,"_12":282},{"_317":318},".gitignore",{"_315":357,"_321":358,"_323":358,"_12":282},{"_317":318},"jira_reporter_server.py",{"_315":360,"_321":361,"_323":361,"_12":282},{"_317":318},"pyproject.toml",{"_315":363,"_321":364,"_323":364,"_12":282},{"_317":318},".python-version",{"_315":366,"_321":367,"_323":367,"_12":282},{"_317":318},"README.md",{"_315":369,"_321":370,"_323":370,"_12":282},{"_317":318},"requirements.txt",{"_315":372,"_321":286,"_323":286,"_12":282},{"_317":318},"actionData","errors"]

MCP directory API