excelsier/things-fastmcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

35 stars 15 forks 品質 58 トレンド 12NOASSERTION

Repository Install

Claude および Windsurf 用の Thing MCP サーバーの FastMCP 実装を強化

概要

このモデルコンテキストプロトコル (MCP) サーバーでは、Claude Desktop を使用して、Thing アプリのタスク管理データとやり取りできます。 Claudeにタスクを作成したり、プロジェクトを分析したり、優先順位を管理したりすることができます。このサーバーは、Things.pyライブラリとThings URL Schemeを活用して、以下のような追加の信頼性機能を備えています。 - 指数関数的なバックオフと再試行メカニズムで - カスケーディングの失敗を防ぐ - 失敗した操作のために - 性能を向上させるために - 構造化されたJSON出力 - URLスキームに失敗した操作 - 物事アプリを圧倒的に防ぐために - 信頼性のためにこのMCPサーバーは、タスク管理のためにAIのパワーを解除します。 - : 自然言語のすべての詳細でタスクを作成するためにClaudeを依頼 - : あなたのプロジェクトや生産性のパターンに洞察を得る - : Claudeは、生産性システムを実装するのに役立ちます - : 既存のもの3データと直接動作します - すべての主要なものリストへのアクセス (受信トレイ、今日、更新など).

概要（AI 翻訳）

このモデルコンテキストプロトコル (MCP) サーバーでは、Claude Desktop を使用して、Thing アプリのタスク管理データとやり取りできます。 Claudeにタスクを作成したり、プロジェクトを分析したり、優先順位を管理したりすることができます。

このサーバーは、Things.pyライブラリとThings URL Schemeを活用して、以下のような追加の信頼性機能を備えています。

ボタンのエラー処理と、指数関数のバックオフとリトライ機構
回路のブレーカパターンは、キャスケーディングの失敗を防ぐため -失敗した操作のためのデアドレターキュー
改善された性能のための理性的なキャッシュ
構造化されたJSONの出力の総合ロギング
AppleScript Bridge URLスキームに失敗した操作の場合 -** 圧倒的なモノアプリを防止するために制限を付与**
信頼性のための広範囲のテストスイート*

なぜ物事MCP?

このMCPサーバーは、タスク管理のためにAIのパワーを解除します。

-Natural Language Task Creation: 自然言語のすべての詳細でタスクを作成するためにClaudeを依頼する -スマートタスク分析:プロジェクトや生産性のパターンに洞察を得る

GTD&生産性ワークフロー: Claudeが生産性システムを実装するのに役立ちます

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Things MCP Server

This Model Context Protocol (MCP) server lets you use Claude Desktop to interact with your task management data in Things app. You can ask Claude to create tasks, analyze projects, help manage priorities, and more.

This server leverages the Things.py library and the Things URL Scheme, with additional reliability features including:

Robust error handling with exponential backoff and retry mechanisms
Circuit breaker pattern to prevent cascading failures
Dead letter queue for failed operations
Intelligent caching for improved performance
Comprehensive logging with structured JSON output
AppleScript bridge for operations that fail with URL schemes
Rate limiting to prevent overwhelming the Things app
Extensive test suite for reliability

Why Things MCP?

This MCP server unlocks the power of AI for your task management:

Natural Language Task Creation: Ask Claude to create tasks with all details in natural language
Smart Task Analysis: Get insights into your projects and productivity patterns
GTD & Productivity Workflows: Let Claude help you implement productivity systems
Seamless Integration: Works directly with your existing Things 3 data

Features

Access to all major Things lists (Inbox, Today, Upcoming, etc.)
Project and area management
Tag operations
Advanced search capabilities
Recent items tracking
Detailed item information including checklists
Support for nested data (projects within areas, todos within projects)

Installation Options

There are multiple ways to install and use the Things MCP server:

Option 1: Install from PyPI (Recommended)

Prerequisites

Python 3.12+
Claude Desktop
Things 3 (“Enable Things URLs” must be turned on in Settings -> General)
Things Authentication Token (required for URL scheme operations)

Installation

pip install things-mcp

Or using uv (recommended):

uv pip install things-mcp

Running

After installation, you can run the server directly:

things-mcp

Option 2: Manual Installation

Prerequisites

Python 3.12+
Claude Desktop
Things 3 (“Enable Things URLs” must be turned on in Settings -> General)

Step 1: Install uv

Install uv if you haven’t already:

curl -LsSf https://astral.sh/uv/install.sh | sh

Restart your terminal afterwards.

Step 2: Clone this repository

git clone https://github.com/hald/things-mcp
cd things-mcp

Step 3: Set up Python environment and dependencies

uv venv
uv pip install -r pyproject.toml

Step 4: Configure Things authentication token

Run the configuration tool to set up your Things authentication token:

python configure_token.py

GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
    "mcpServers": {
        "things": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/things-mcp",
                "run",
                "things_server.py"
            ]
        }
    }
}