Skip to main content
Glama
hkopenai

Hong Kong community and social welfare MCP Server

by hkopenai

Hong Kong community and social welfare MCP Server

GitHub Repository License: MIT

This is an MCP server that provides access to government community and social welfare data through a FastMCP interface.

Features

Elderly Community Care Services

  • Retrieve data on the number of applicants and average waiting time for subsidized community care services for the elderly in Hong Kong url

Related MCP server: hk-housing-mcp-server

Data Source

  • Elderly community care services data from Social Welfare Department

Examples

  • Retrieve latest waiting time data subsidized community care services for elderly community care services in Hong Kong

Setup

  1. Clone this repository

  2. Install Python dependencies:

    pip install -r requirements.txt
  3. Run the server:

    python server.py

Running Options

  • Default stdio mode: python server.py

  • SSE mode (port 8000): python server.py --sse

Cline Integration

To connect this MCP server to Cline using stdio:

  1. Add this configuration to your Cline MCP settings (cline_mcp_settings.json):

{
  "hk-community": {
    "disabled": false,
    "timeout": 3,
    "type": "stdio",
    "command": "uvx",
    "args": [
      "hkopenai.hk-community-mcp-server"
    ]
  }
}

Testing

Tests are available in the tests/ directory. Run with:

pytest

Available Tools

1 tool
get_elderly_community_care_servicesA

Retrieve data on the number of applicants and average waiting time for subsidised community care services for the elderly in Hong Kong.

ParametersJSON Schema
NameRequiredDescriptionDefault
end_yearYesEnd year for data range
start_yearYesStart year for data range

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden. It communicates a read-only action ('Retrieve') and implies no side effects, but it does not disclose potential limitations such as year range constraints, data aggregation, or response size.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, focused sentence that front-loads the core action and resource. No words are wasted.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool is simple, with two well-documented parameters and an output schema. The description provides sufficient context about the data source and metrics, though it could note that years refer to reporting periods.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema fully documents both parameters (start_year and end_year) with descriptive text, achieving 100% coverage. The description adds no extra parameter semantics such as valid ranges or format expectations, so it meets the baseline.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool retrieves data on applicants and average waiting time for elderly community care services in Hong Kong. This specific verb-resource combination leaves no ambiguity about what the tool returns.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No sibling tools are listed and no alternative options are mentioned. The description implies usage whenever this specific data is needed, but it does not explicitly say when to use versus not use the tool.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

TDQS

A3.6/5.0
Disambiguation5/5

There is only one tool, so there is no possibility of confusing it with another tool. Its purpose is clearly defined in the name and description.

Naming Consistency5/5

The tool name follows a clear verb_noun pattern ('get_elderly_community_care_services'), which is consistent and descriptive. Even though it is a single tool, the naming convention is sound.

Tool Count2/5

A server named 'Hong Kong community and social welfare' would be expected to cover many areas, but it has only one tool focused on elderly community care. This is too few for the apparent scope.

Completeness1/5

The tool only covers one specific service (elderly community care), leaving out many other social welfare domains such as youth, family, disability, and housing support. This is a severe gap for the stated purpose.

Maintenance

ActivityMaintained
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    C
    maintenance
    Enables access to Hong Kong government's official open data portal (DATA.GOV.HK) through natural language queries. Supports searching datasets, browsing categories, and retrieving detailed information about Hong Kong's public data resources.
    8
    8
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables querying Hong Kong private storage statistics such as completions, stock, and vacancy data via a FastMCP interface, sourced from the Rating and Valuation Department.
    1
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Enables querying of current A\&E waiting times, specialist outpatient waiting times, and general outpatient clinic quotas in Hong Kong using natural language through MCP.
    3
    4
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/hkopenai/hk-community-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server