mcp_coingecko_price_ts 1.0.1 → 1.0.4

package/.github/copilot-instructions.md

@@ -1,17 +1,17 @@
-- [x] Verify that the copilot-instructions.md file in the .github directory is created.
-
-- [x] Clarify Project Requirements
-
-- [x] Scaffold the Project
-
-- [x] Customize the Project
-
-- [x] Install Required Extensions
-
-- [x] Compile the Project
-
-- [x] Create and Run Task
-
-- [x] Launch the Project
-
-- [x] Ensure Documentation is Complete
+- [x] Verify that the copilot-instructions.md file in the .github directory is created.
+
+- [x] Clarify Project Requirements
+
+- [x] Scaffold the Project
+
+- [x] Customize the Project
+
+- [x] Install Required Extensions
+
+- [x] Compile the Project
+
+- [x] Create and Run Task
+
+- [x] Launch the Project
+
+- [x] Ensure Documentation is Complete

package/.github/workflows/publish.yaml

@@ -0,0 +1,22 @@
+name: Publish Package
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'  # Trigger on version tags like v1.0.0
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+      - run: npm ci
+      - run: npm run build --if-present
+      - run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} # Use the secret

package/.vscode/launch.json

@@ -1,14 +1,14 @@
-{
-  "version": "0.2.0",
-  "configurations": [
-    {
-      "type": "node",
-      "request": "launch",
-      "name": "Launch Program",
-      "skipFiles": ["<node_internals>/**"],
-      "program": "${workspaceFolder}/src/index.ts",
-      "preLaunchTask": "build",
-      "outFiles": ["${workspaceFolder}/dist/**/*.js"]
-    }
-  ]
-}
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "node",
+      "request": "launch",
+      "name": "Launch Program",
+      "skipFiles": ["<node_internals>/**"],
+      "program": "${workspaceFolder}/src/index.ts",
+      "preLaunchTask": "build",
+      "outFiles": ["${workspaceFolder}/dist/**/*.js"]
+    }
+  ]
+}

package/README.md

@@ -1,95 +1,106 @@
-# CoinGecko Price MCP Server
-
-A simple Model Context Protocol (MCP) server that provides cryptocurrency pricing information using the CoinGecko API.
-
-## Features
-
-- **get_crypto_price**: A tool to fetch the current price of a cryptocurrency in a specific currency.
-  - Inputs:
-    - `crypto_id`: The CoinGecko ID of the cryptocurrency (e.g., 'bitcoin', 'ethereum').
-    - `currency`: The target currency for the price (e.g., 'usd', 'brl').
-
-## Prerequisites
-
-- Node.js (v18 or higher recommended)
-- npm
-
-## Installation
-
-1. Clone or navigate to the project repository.
-2. Install dependencies:
-
-   ```bash
-   npm install
-   ```
-
-## Building the Project
-
-Compile the TypeScript code to JavaScript:
-
-```bash
-npm run build
-```
-
-The compiled output will be in the `dist` directory.
-
-## Usage
-
-### Testing Locally with MCP Inspector (The `npx` Way)
-
-You can test the server interactively using the MCP Inspector. This allows you to inspect tools and resources and make tool calls directly.
-
-1. Build the project first:
-   ```bash
-   npm run build
-   ```
-
-2. Run the inspector using `npx`, pointing it to your built server script:
-
-   ```bash
-   npx @modelcontextprotocol/inspector node dist/index.js
-   ```
-
-   _Note: On Windows, use a full path or ensuring valid path syntax if you encounter issues._
-
-3. Open the URL provided in the terminal (usually `http://localhost:5173`) to interact with your server.
-
-### Running Directly
-
-You can run the server directly (it communicates via Stdio), but it is designed to be used by an MCP client (like Claude Desktop or the Inspector).
-
-```bash
-npm start
-```
-
-### Developing
-
-To run the server in development mode (using `tsx`):
-
-```bash
-npm run dev
-```
-
-## Setup with Claude Desktop
-
-To use this server with Claude Desktop apps:
-
-1. Locate your Claude Desktop configuration file:
-   - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
-   - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
-
-2. Add the server configuration:
-
-   ```json
-   {
-     "mcpServers": {
-       "coingecko": {
-         "command": "node",
-         "args": ["/absolute/path/to/mcp_coingecko_price_ts/dist/index.js"]
-       }
-     }
-   }
-   ```
-   *Remember to run `npm run build` after making changes to the source code.*
-
-3. You can run this mcp with stdio transport using npx command
+# CoinGecko Price MCP Server
+
+A simple Model Context Protocol (MCP) server that provides cryptocurrency pricing information using the CoinGecko API.
+
+## Features
+
+- **get_crypto_price**: A tool to fetch the current price of a cryptocurrency in a specific currency.
+  - Inputs:
+    - `crypto_id`: The CoinGecko ID of the cryptocurrency (e.g., 'bitcoin', 'ethereum').
+    - `currency`: The target currency for the price (e.g., 'usd', 'brl').
+
+## Prerequisites
+
+- Node.js (v18 or higher recommended)
+- npm
+
+## Installation
+
+1. Clone or navigate to the project repository.
+2. Install dependencies:
+
+   ```bash
+   npm install
+   ```
+
+## Building the Project
+
+Compile the TypeScript code to JavaScript:
+
+```bash
+npm run build
+```
+
+The compiled output will be in the `dist` directory.
+
+## Usage
+
+### Testing Locally with MCP Inspector (The `npx` Way)
+
+You can test the server interactively using the MCP Inspector. This allows you to inspect tools and resources and make tool calls directly.
+
+1. Build the project first:
+   ```bash
+   npm run build
+   ```
+
+2. Run the inspector using `npx`, pointing it to your built server script:
+
+   ```bash
+   npx @modelcontextprotocol/inspector node dist/index.js
+   ```
+
+   _Note: On Windows, use a full path or ensuring valid path syntax if you encounter issues._
+
+3. Open the URL provided in the terminal (usually `http://localhost:5173`) to interact with your server.
+
+### Running Directly
+
+You can run the server directly (it communicates via Stdio), but it is designed to be used by an MCP client (like Claude Desktop or the Inspector).
+
+```bash
+npm start
+```
+
+### Developing
+
+To run the server in development mode (using `tsx`):
+
+```bash
+npm run dev
+```
+
+## Setup with Claude Desktop
+
+To use this server with Claude Desktop apps:
+
+1. Locate your Claude Desktop configuration file:
+   - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+   - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+2. Add the server configuration:
+
+   ```json
+   {
+     "mcpServers": {
+       "coingecko_price": {
+         "command": "node",
+         "args": ["/absolute/path/to/mcp_coingecko_price_ts/dist/index.js"]
+       }
+     }
+   }
+   ```
+   *Remember to run `npm run build` after making changes to the source code.*
+
+3. You can run this mcp with stdio transport using npx command
+
+    ```json
+    {
+     "mcpServers": {
+       "coingecko_price": {
+         "command": "npx",
+         "args": ["-y", "mcp_coingecko_price_ts"]
+       }
+     }
+   }
+    ```

package/dist/index.d.ts

@@ -1,2 +1,3 @@
+#!/usr/bin/env node
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,12 +1,13 @@
+#!/usr/bin/env node
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import * as z from 'zod/v4';
 const mcpServer = new McpServer({
-    name: 'tools-with-sample-server',
+    name: 'mcp_coingecko_price_ts',
     version: '1.0.0'
 });
 console.log('McpServer started');
-mcpServer.registerTool('coingecko-price-ts', {
+mcpServer.registerTool('get_crypto_price', {
     title: 'Get Cryptocurrency Price',
     description: 'Get the current price of a cryptocurrency from CoinGecko.',
     inputSchema: {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC;IAC5B,IAAI,EAAE,0BAA0B;IAChC,OAAO,EAAE,OAAO;CACnB,CAAC,CAAC;AAEH,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AAEjC,SAAS,CAAC,YAAY,CAClB,oBAAoB,EACpB;IACI,KAAK,EAAE,0BAA0B;IACjC,WAAW,EAAE,2DAA2D;IACxE,WAAW,EAAE;QACT,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;KACvB;CACJ,EACD,KAAK,EAAG,EAAC,SAAS,EAAE,QAAQ,EAAC,EAAG,EAAE;IAC9B,MAAM,QAAQ,GAAG,MAAM,KAAK,CACxB,qDAAqD,SAAS,kBAAkB,QAAQ,EAAE,CAC7F,CAAC;IACF,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,wBAAwB,SAAS,OAAO,QAAQ,OAAO,KAAK,EAAE,CAAC;IAC9E,OAAO;QACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;KAC5C,CAAC;AACN,CAAC,CACJ,CAAC;AACF,KAAK,UAAU,IAAI;IACf,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AAC5C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;IACjB,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC;IAC5B,IAAI,EAAE,wBAAwB;IAC9B,OAAO,EAAE,OAAO;CACnB,CAAC,CAAC;AAEH,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AAEjC,SAAS,CAAC,YAAY,CAClB,kBAAkB,EAClB;IACI,KAAK,EAAE,0BAA0B;IACjC,WAAW,EAAE,2DAA2D;IACxE,WAAW,EAAE;QACT,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;KACvB;CACJ,EACD,KAAK,EAAG,EAAC,SAAS,EAAE,QAAQ,EAAC,EAAG,EAAE;IAC9B,MAAM,QAAQ,GAAG,MAAM,KAAK,CACxB,qDAAqD,SAAS,kBAAkB,QAAQ,EAAE,CAC7F,CAAC;IACF,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,wBAAwB,SAAS,OAAO,QAAQ,OAAO,KAAK,EAAE,CAAC;IAC9E,OAAO;QACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;KAC5C,CAAC;AACN,CAAC,CACJ,CAAC;AACF,KAAK,UAAU,IAAI;IACf,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AAC5C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;IACjB,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "mcp_coingecko_price_ts",
-  "version": "1.0.1",
+  "version": "1.0.4",
   "type": "module",
+  "bin": {
+    "mcp_coingecko_price_ts": "./dist/index.js"
+  },
   "main": "dist/index.js",
   "scripts": {
     "build": "tsc",

package/src/index.ts

@@ -1,43 +1,44 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import * as z from 'zod/v4';
-
-const mcpServer = new McpServer({
-    name: 'mcp_coingecko_price_ts',
-    version: '1.0.0'
-});
-
-console.log('McpServer started');
-
-mcpServer.registerTool(
-    'get_crypto_price',
-    {
-        title: 'Get Cryptocurrency Price',
-        description: 'Get the current price of a cryptocurrency from CoinGecko.',
-        inputSchema: {
-            crypto_id: z.string(),
-            currency: z.string()
-        }
-    },
-    async ( {crypto_id, currency} ) => {
-        const response = await fetch(
-            `https://api.coingecko.com/api/v3/simple/price?ids=${crypto_id}&vs_currencies=${currency}`
-        );
-        const data = await response.json();
-        const price = data[crypto_id][currency];
-        const output = `The current price of ${crypto_id} in ${currency} is ${price}`;
-        return {
-            content: [{ type: 'text', text: output }],
-        };
-    }
-);
-async function main() {
-    const transport = new StdioServerTransport();
-    await mcpServer.connect(transport);
-    console.log('MCP server is running...');
-}
-
-main().catch(error => {
-    console.error('Server error:', error);
-    process.exit(1);
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import * as z from 'zod/v4';
+
+const mcpServer = new McpServer({
+    name: 'mcp_coingecko_price_ts',
+    version: '1.0.0'
+});
+
+console.log('McpServer started');
+
+mcpServer.registerTool(
+    'get_crypto_price',
+    {
+        title: 'Get Cryptocurrency Price',
+        description: 'Get the current price of a cryptocurrency from CoinGecko.',
+        inputSchema: {
+            crypto_id: z.string(),
+            currency: z.string()
+        }
+    },
+    async ( {crypto_id, currency} ) => {
+        const response = await fetch(
+            `https://api.coingecko.com/api/v3/simple/price?ids=${crypto_id}&vs_currencies=${currency}`
+        );
+        const data = await response.json();
+        const price = data[crypto_id][currency];
+        const output = `The current price of ${crypto_id} in ${currency} is ${price}`;
+        return {
+            content: [{ type: 'text', text: output }],
+        };
+    }
+);
+async function main() {
+    const transport = new StdioServerTransport();
+    await mcpServer.connect(transport);
+    console.log('MCP server is running...');
+}
+
+main().catch(error => {
+    console.error('Server error:', error);
+    process.exit(1);
 });

package/tsconfig.json

@@ -1,44 +1,44 @@
-{
-  // Visit https://aka.ms/tsconfig to read more about this file
-  "compilerOptions": {
-    // File Layout
-    "rootDir": "./src",
-    "outDir": "./dist",
-
-    // Environment Settings
-    // See also https://aka.ms/tsconfig/module
-    "module": "nodenext",
-    "target": "esnext",
-    // "types": [],
-    // For nodejs:
-    // "lib": ["esnext"],
-    // "types": ["node"],
-    // and npm install -D @types/node
-
-    // Other Outputs
-    "sourceMap": true,
-    "declaration": true,
-    "declarationMap": true,
-
-    // Stricter Typechecking Options
-    "noUncheckedIndexedAccess": true,
-    "exactOptionalPropertyTypes": true,
-
-    // Style Options
-    // "noImplicitReturns": true,
-    // "noImplicitOverride": true,
-    // "noUnusedLocals": true,
-    // "noUnusedParameters": true,
-    // "noFallthroughCasesInSwitch": true,
-    // "noPropertyAccessFromIndexSignature": true,
-
-    // Recommended Options
-    "strict": true,
-    "jsx": "react-jsx",
-    "verbatimModuleSyntax": true,
-    "isolatedModules": true,
-    "noUncheckedSideEffectImports": true,
-    "moduleDetection": "force",
-    "skipLibCheck": true,
-  }
-}
+{
+  // Visit https://aka.ms/tsconfig to read more about this file
+  "compilerOptions": {
+    // File Layout
+    "rootDir": "./src",
+    "outDir": "./dist",
+
+    // Environment Settings
+    // See also https://aka.ms/tsconfig/module
+    "module": "nodenext",
+    "target": "esnext",
+    // "types": [],
+    // For nodejs:
+    // "lib": ["esnext"],
+    // "types": ["node"],
+    // and npm install -D @types/node
+
+    // Other Outputs
+    "sourceMap": true,
+    "declaration": true,
+    "declarationMap": true,
+
+    // Stricter Typechecking Options
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+
+    // Style Options
+    // "noImplicitReturns": true,
+    // "noImplicitOverride": true,
+    // "noUnusedLocals": true,
+    // "noUnusedParameters": true,
+    // "noFallthroughCasesInSwitch": true,
+    // "noPropertyAccessFromIndexSignature": true,
+
+    // Recommended Options
+    "strict": true,
+    "jsx": "react-jsx",
+    "verbatimModuleSyntax": true,
+    "isolatedModules": true,
+    "noUncheckedSideEffectImports": true,
+    "moduleDetection": "force",
+    "skipLibCheck": true,
+  }
+}