genjo-mcp-server 1.0.0

package/README.md

@@ -0,0 +1,57 @@
+# Genjo MCP Server
+
+This is the Model Context Protocol (MCP) server for the Genjo AI News System.
+It allows you to access Genjo's features from Claude Desktop or Claude Code.
+
+## Usage
+
+### Prerequisites
+- Node.js 18 or higher
+
+### Installation
+
+You can run this server directly using `npx` or by installing it globally.
+
+#### Option 1: Run directly (Recommended)
+
+```bash
+npx -y genjo-mcp-server
+```
+
+#### Option 2: Install globally
+
+```bash
+npm install -g genjo-mcp-server
+genjo-mcp
+```
+
+#### Option 3: Smithery.ai (Automated)
+
+You can install this server from Smithery.ai to easily integrate with Claude Desktop.
+
+### Configuration for Claude Desktop
+
+Add the following to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "genjo": {
+      "command": "npx",
+      "args": ["-y", "genjo-mcp-server"],
+      "env": {
+        "GENJO_API_BASE_URL": "https://api.gen-jo.com"
+      }
+    }
+  }
+}
+```
+
+If you have an API Key (optional), add it to the `env` section:
+```json
+"GENJO_API_KEY": "your_api_key"
+```
+
+## AI Agent Optimization
+
+We have included a `Skills.md` file in this package. If you are using this server with an AI agent that supports skill definitions, providing the content of `Skills.md` in the system prompt or context window will significantly improve the agent's ability to use the tools effectively.

package/Skills.md

@@ -0,0 +1,86 @@
+# Genjo MCP Server Skills Guide
+
+This guide describes the capabilities of the Genjo MCP Server and provides best practices for AI agents to effectively utilize its tools.
+
+## 🧠 Core Capabilities
+
+Genjo is an AI News Agent specialized in Asian markets and multilingual content. This MCP server provides access to:
+
+1.  **Real-time AI News**: Aggregated from global sources.
+2.  **Deep Analysis**: Fact-checking, simple explanations, and related stock analysis.
+3.  **Multilingual Support**: Content available in Japanese (ja), English (en), Chinese (zh), Korean (ko), and Hindi (hi).
+
+## 🛠️ Tool Definitions & Usage
+
+### 1. `get_latest_news`
+**Purpose**: Retrieves the most recent AI news items generated today.
+**Best for**: "What's new in AI today?", "Give me a daily AI news summary."
+
+-   **Params**:
+    -   `lang` (optional): Language code (default: "ja").
+-   **Output**: List of news items with IDs, titles, summaries, and source URLs.
+
+### 2. `get_news_detail`
+**Purpose**: Fetches the full content of a specific news item.
+**Best for**: "Tell me more about news ID 123.", "Read the full article for the first news item."
+
+-   **Params**:
+    -   `id` (required): The numeric ID of the news item.
+    -   `lang` (optional): Language code.
+-   **Output**: Full markdown content of the news item.
+
+### 3. `get_simple_explanation`
+**Purpose**: Provides a beginner-friendly explanation of a complex news topic.
+**Best for**: "Explain this news to a 5-year-old.", "What does this actually mean?"
+
+-   **Params**:
+    -   `id` (required): News ID.
+    -   `lang` (optional): Language code.
+-   **Output**: A simplified explanation text.
+
+### 4. `get_fact_check`
+**Purpose**:verifies the claims in a news item against multiple sources.
+**Best for**: "Is this true?", "Are there any hallucinations in this article?", "Verify the sources."
+
+-   **Params**:
+    -   `id` (required): News ID.
+    -   `lang` (optional): Language code.
+-   **Output**: A structured fact-check report including verdict (True/False/Unverified) and sources.
+
+### 5. `get_related_stocks`
+**Purpose**: Identifies public companies related to the news and analyzes potential market impact.
+**Best for**: "Which stocks might move because of this?", "Investment impact analysis."
+
+-   **Params**:
+    -   `id` (required): News ID.
+    -   `lang` (optional): Language code.
+-   **Output**: List of related tickers, relevance scores, and impact analysis.
+
+### 6. `get_past_news`
+**Purpose**: Searches historical news database.
+**Best for**: "What happened last week?", "Search for news about OpenAI from previous days."
+
+-   **Params**:
+    -   `lang` (optional): Language code.
+    -   `offset` (optional): Pagination offset.
+    -   `limit` (optional): Number of items (default: 10).
+-   **Output**: Chronological list of past news items.
+
+## 🔄 Common Usage Patterns
+
+### Pattern A: Daily Briefing & Deep Dive
+1.  Call `get_latest_news(lang="en")` to get a list of headlines.
+2.  Identify interesting items (e.g., ID: 105).
+3.  Call `get_news_detail(id=105)` to read the full content.
+4.  If the content is complex, call `get_simple_explanation(id=105)`.
+
+### Pattern B: Investment Research
+1.  Call `get_latest_news()` to monitor market-moving news.
+2.  For a significant event (e.g., "NVIDIA announces new chip"), call `get_related_stocks(id=...)`.
+3.  Call `get_fact_check(id=...)` to ensure the news isn't a rumor before acting.
+
+## ⚠️ Error Handling
+
+-   **404 Not Found**: The news ID might be invalid or too old. Try `get_latest_news` again to get fresh IDs.
+-   **API Error**: If the backend is down, wait a moment and retry.
+-   **Language Fallback**: If content isn't available in the requested language, the server may return English content. Always check the output language.