matome-mcp-server 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 evilock
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,63 @@
+# MCP Server for Matome Subscribers
+
+This repository hosts the **MCP server for subscribers of the Matome service**.  
+It enables context sharing and integration with external models via the Model Context Protocol (MCP).
+
+---
+
+## Overview
+
+This server is exclusively provided for Matome subscribers.  
+Subscribers can use the **UID issued by Matome** to share bookmarked URLs with MCP-compatible clients.
+
+---
+
+## Key Features
+
+- Provides bookmarked URLs linked to a Matome UID
+- Can be combined with browser search MCPs to create summaries of your bookmarks
+
+---
+
+## How to Use
+
+1. Log in to Matome and obtain your UID for MCP integration.
+2. Use the URL with your MCP-compatible client and set the UID as an environment variable.
+3. Example configuration for Claude MCP client:
+
+```claude_desktop_config.json
+"matome": {
+  "command": "npx",
+  "args": ["matome-mcp-server"],
+  "env": {
+    "USER_ID": "{YOUR UID}"
+  }
+}
+```
+
+4. Integration with BraveAPI:
+
+```claude_desktop_config.json
+"brave-search": {
+  "command": "npx",
+  "args": ["-y", "@modelcontextprotocol/server-brave-search"],
+  "env": {
+    "BRAVE_API_KEY": "{YOUR API KEY}"
+  }
+}
+```
+
+5. Prompt for summarization:
+   [matome で取得した url の内容をまとめて]
+
+---
+
+Notes
+
+This service is available to anyone who knows a valid Matome UID.
+The UID must be set to public: true in Matome to be used.
+Even non-Matome users can retrieve data if they know someone’s public UID.
+
+---
+
+License

package/dist/index.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { MCPServer } from "mcp-framework";
+const server = new MCPServer();
+server.start();

package/dist/tools/ExampleTool.js

@@ -0,0 +1,16 @@
+import { MCPTool } from "mcp-framework";
+import { z } from "zod";
+class ExampleTool extends MCPTool {
+    name = "example_tool";
+    description = "An example tool that processes messages";
+    schema = {
+        message: {
+            type: z.string(),
+            description: "Message to process",
+        },
+    };
+    async execute(input) {
+        return `Processed: ${input.message}`;
+    }
+}
+export default ExampleTool;

package/dist/tools/MatomeTool.js

@@ -0,0 +1,51 @@
+import { MCPTool } from "mcp-framework";
+import { z } from "zod";
+import "dotenv/config";
+class MatomeTool extends MCPTool {
+    name = "get_matome_url_list";
+    description = "Matomeに登録したurlを取得する";
+    MATOME_API_BASE = "https://matome.ebi-generator.com/api/mcp";
+    schema = {
+        message: {
+            type: z.string(),
+            description: "Message to process",
+        },
+    };
+    async execute() {
+        try {
+            const Url = `${this.MATOME_API_BASE}`;
+            const UID = process.env.USER_ID;
+            const response = await fetch(Url, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify({ uid: UID }),
+            });
+            if (response.status !== 200) {
+                return { content: [{ type: "text", text: "matome fetch Error!!" }] };
+            }
+            else {
+                const result = await response.json();
+                // const resultlist: BASE_CONTENT = { content: [] };
+                // result.list.forEach((item) => {
+                //   resultlist.content.push({ type: "text", text: item.url });
+                // });
+                // return resultlist;
+                return result;
+            }
+        }
+        catch {
+            return {
+                list: [{ type: "error", url: "" }],
+                // content: [
+                //   {
+                //     type: "text",
+                //     text: "matome url list is none",
+                //   },
+                // ],
+            };
+        }
+    }
+}
+export default MatomeTool;

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "matome-mcp-server",
+  "version": "0.0.1",
+  "description": "matome-mcp-server MCP server",
+  "type": "module",
+  "bin": {
+    "matome-mcp-server": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && mcp-build",
+    "watch": "tsc --watch",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "dotenv": "^16.5.0",
+    "mcp-framework": "^0.2.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.24",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.19.0"
+  }
+}