Hourei MCP Server

🚀 Hourei MCP Server

This is an MCP server that uses the e-Gov Law API to search for and retrieve Japanese law information.

🚀 Quick Start

The Hourei MCP Server is designed to facilitate the search and retrieval of Japanese law information using the e - Gov Law API. You can quickly integrate it into various clients to access law - related data.

✨ Features

This MCP server provides the following tools:

1. search_law

Search for laws by law name or law number.

Parameters:

• keyword (Required): Search keyword (part of the law name or law number).
• category (Optional): Type of law.
  • 1: Laws
  • 2: Cabinet Orders
  • 3: Ministerial Ordinances
  • 4: Rules
  • 5: Others
• limit (Optional): Maximum number of items to retrieve (Default: 100).

2. get_law_data

Retrieve detailed data of a law by specifying the law number.

Parameters:

• lawNum (Required): Law number (e.g., Act No. 117 of 2005).

3. get_law_revision

Retrieve the revision history of a law.

Parameters:

• lawNum (Required): Law number.

📦 Installation

Install via npm (Recommended)

npx hourei-mcp-server

Local Development

git clone <repository-url>
cd hourei-mcp-server
npm install

💻 Usage Examples

Configuration in MCP Clients

Configuration in Claude Desktop

Add the following to the configuration file (~/Library/Application Support/Claude/claude_desktop_config.json) of clients such as Claude Desktop:

{
  "mcpServers": {
    "hourei": {
      "command": "npx",
      "args": ["-y", "hourei-mcp-server"]
    }
  }
}

After the configuration, restart Claude Desktop.

Configuration in Cursor AI

Add the following to the Cursor configuration file (.cursor/mcp_config.json or the settings screen):

{
  "mcpServers": {
    "hourei": {
      "command": "npx",
      "args": ["-y", "hourei-mcp-server"]
    }
  }
}

Configuration in ChatGPT Desktop

In ChatGPT, configure it by specifying the URL of the MCP server.

Option 1: Run with the npx command (same as other clients)

{
  "mcpServers": {
    "hourei": {
      "command": "npx",
      "args": ["-y", "hourei-mcp-server"]
    }
  }
}

Option 2: Specify in URL format (via SSE server)

If you start an SSE - compatible server separately:

{
  "mcpServers": {
    "hourei": {
      "url": "http://localhost:3000/sse"
    }
  }
}

Or, if deployed to a remote server:

{
  "mcpServers": {
    "hourei": {
      "url": "https://your-server.com/sse"
    }
  }
}

Note: The current version (v1.0.5) only supports stdio connections. If you use the URL format, you need a separate SSE - compatible wrapper server.

Configuration in Manus

Add the following to the Manus configuration file:

{
  "mcpServers": {
    "hourei": {
      "command": "npx",
      "args": ["-y", "hourei-mcp-server"]
    }
  }
}

Configuration in Dify

When using the MCP tool in a Dify agent:

1. Add to the Dify configuration file Specify the following in the environment variables or Dify settings:

{
  "mcpServers": {
    "hourei": {
      "command": "npx",
      "args": ["-y", "hourei-mcp-server"]
    }
  }
}

2. Use in the agent block Add a "Tool" block in the Dify workflow and select the following MCP tools:

• search_law - Search for laws
• get_law_data - Retrieve detailed law data
• get_law_revision - Retrieve revision history

3. Usage example: Law search agent

Input block → LLM block → Tool block (search_law) → Output block

Example of parameter settings for the tool block:

{
  "keyword": "{{user_input}}",
  "category": "1",
  "limit": 100
}

Run with a local path (for development)

{
  "mcpServers": {
    "hourei": {
      "command": "node",
      "args": ["/path/to/hourei-mcp-server/index.js"]
    }
  }
}

Specific Usage Examples

1. Keyword Search for Laws

Search for laws related to personal information protection:

{
  "keyword": "Personal information protection",
  "category": "1"  // Only laws
}

Search for the Labor Standards Act:

{
  "keyword": "Labor Standards Act"
}

Search for cabinet orders related to consumption tax:

{
  "keyword": "Consumption tax",
  "category": "2",  // Cabinet Orders
  "limit": 50
}

2. Retrieve Detailed Law Data

Retrieve the full text of the Personal Information Protection Act:

{
  "lawNum": "Act No. 57 of 2003"
}

Retrieve the full text of the Civil Code:

{
  "lawNum": "Act No. 89 of 1896"
}

Retrieve the full text of the Criminal Code:

{
  "lawNum": "Act No. 45 of 1907"
}

3. Check the Revision History of Laws

Revision history of the Personal Information Protection Act:

{
  "lawNum": "Act No. 57 of 2003"
}

📚 Documentation

What Can Be Done

✅ Law Search

• Search for laws by keyword.
• Narrow down by types such as laws, cabinet orders, and ministerial ordinances.
• Retrieve up to 100 items at a time.

✅ Retrieve Law Data

• Retrieve the full text by specifying the law number.
• Structured data in XML format.
• Includes hierarchical structures such as articles, paragraphs, and items.

✅ Check Revision History

• Find out when and how a law was revised.
• Retrieve information on revised laws.
• Confirm the enforcement date.

✅ Use Cases

• Legal research.
• Compliance checks.
• Reference when drafting contracts.
• Confirmation of legal compliance.
• Assistance for legal consultations.
• Tracking of legal revisions.
• Automation of law search with Dify agents.
• Integration of law knowledge into chatbots.

Supported Clients

• ✅ Claude Desktop (via npx)
• ✅ Cursor AI (via npx)
• ✅ ChatGPT Desktop (via npx or URL format)
• ✅ Manus (via npx)
• ✅ Dify (agent workflow)
• ✅ Other MCP - compatible clients (supports stdio connections)

🔧 Technical Details

• Node.js ESM format.
• MCP SDK v0.5.0.
• Uses e - Gov Law API v2.
• Supported format: XML.

Development

Clone the Repository

git clone https://github.com/yourusername/hourei-mcp-server.git
cd hourei-mcp-server
npm install

Local Testing

node index.js

📄 License

This project is licensed under the MIT license.

🤝 Contribution

Pull Requests are welcome!

🆘 Support

If you encounter any issues, please report them in Issues.