Skip to main content
Glama
Sign In
enesjakozh

Targetprocess MCP Server

by aaronsb
Verified
GitHub
TypeScript
MIT License
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Provides tools for interacting with Targetprocess, a project management and agile planning platform. Enables searching, creating, and updating entities (User Stories, Bugs, Tasks, Features, etc.), querying with complex filters, exploring data models and relationships, and handling authentication and API interactions.

Servidor MCP de Targetprocess

El Protocolo de Contexto de Modelo (MCP) es un estándar que permite a los asistentes de IA interactuar con herramientas y servicios externos a través de una interfaz unificada. Los servidores MCP proporcionan estas capacidades al exponer herramientas y recursos que los asistentes de IA pueden usar para realizar tareas.

Este servidor MCP proporciona herramientas para interactuar con Targetprocess, una plataforma de gestión de proyectos y planificación ágil. Permite a los asistentes de IA:

  • Busque y recupere entidades de Targetprocess (historias de usuario, errores, tareas, características, etc.)
  • Crear y actualizar entidades con la validación adecuada
  • Consultar entidades con filtros complejos e inclusiones
  • Inspeccionar y descubrir el modelo de datos de Targetprocess
  • Manejar la autenticación y las interacciones API de forma segura

Características principales

  • Descubrimiento de modelos de datos : explore y comprenda implementaciones complejas de Targetprocess
  • Consultas potentes : utilice filtros complejos e inclusiones para recuperar exactamente los datos que necesita
  • Gestión de entidades : crear y actualizar entidades con la validación adecuada
  • Exploración de relaciones : comprender cómo se relacionan diferentes entidades entre sí
  • Manejo de errores : Manejo de errores robusto con reintentos y mensajes informativos
  • Integración de documentación : acceso integrado a la documentación de Targetprocess

Casos de uso

Este servidor MCP es especialmente valioso en entornos corporativos donde Targetprocess puede gestionar millones de registros con esquemas y modelos de datos complejos. Algunos casos de uso comunes incluyen:

  • Descubrimiento de modelos de datos : mapee y comprenda implementaciones complejas de Targetprocess
  • Análisis empresarial : extraiga y analice datos de millones de registros
  • Integración entre sistemas : Úselo como puente entre Targetprocess y otros sistemas
  • Informes personalizados : cree informes especializados que no están disponibles en la interfaz de usuario estándar
  • Operaciones por lotes : gestione cambios a gran escala en muchas entidades
  • Exploración de esquemas : descubra campos y relaciones personalizados en implementaciones complejas

Para obtener ejemplos detallados y guías de implementación, consulte USECASES.md .

Empezando

Clonar el repositorio recursivamente para incluir la herramienta de búsqueda de documentación:

git clone --recursive https://github.com/aaronsb/apptio-target-process-mcp.git cd apptio-target-process-mcp

Recursos de desarrollo

Búsqueda de documentación

Este repositorio incluye un buscador de documentación para desarrolladores de Targetprocess como submódulo. Puede usarlo para buscar rápidamente en la documentación de Targetprocess:

# From the project root: pushd resources/target-process-docs && npm install && ./refresh-docs.sh && popd # First time setup # To search documentation (from any directory): pushd resources/target-process-docs && ./search-docs.sh "your search query" && popd # Example search: pushd resources/target-process-docs && ./search-docs.sh "entity states" && popd

La herramienta de búsqueda se encuentra en recursos/target-process-docs. Usamos los comandos pushd/popd porque:

  1. La herramienta requiere acceso a sus archivos de base de datos mediante rutas relativas
  2. pushd guarda la ubicación actual de su directorio
  3. Cambia temporalmente el directorio de la herramienta para ejecutar el comando
  4. popd lo regresa automáticamente a su ubicación anterior. Este enfoque le permite ejecutar búsquedas desde cualquier directorio y garantizar que la herramienta pueda encontrar sus archivos de base de datos.

Esta herramienta ofrece una potente herramienta para buscar localmente en la documentación para desarrolladores de Targetprocess. Los resultados incluyen secciones de documentación relevantes con contexto, lo que facilita la búsqueda de detalles específicos de la API o guías de implementación.

Canalización de CI/CD

El proyecto utiliza GitHub Actions para compilaciones automatizadas:

  • Los envíos a la rama main activan nuevas compilaciones de contenedores
  • Las etiquetas de versión (v*. . ) crean versiones versionadas
  • Las imágenes se publican en GitHub Container Registry

Puedes utilizar la imagen publicada:

docker run -i --rm \ -e TP_DOMAIN=your-domain.tpondemand.com \ -e TP_USERNAME=your-username \ -e TP_PASSWORD=your-password \ ghcr.io/aaronsb/apptio-target-process-mcp

Variables de entorno

  • TP_DOMAIN : Su dominio de Targetprocess (por ejemplo, company.tpondemand.com)
  • TP_USERNAME : Su nombre de usuario de Targetprocess
  • TP_PASSWORD : Su contraseña de Targetprocess

Desarrollo local con Docker

Para el desarrollo y pruebas locales, utilice los scripts proporcionados:

  1. Construir la imagen local:

    Nota: El script de compilación usa el modo silencioso de Docker por defecto para minimizar la salida del registro. Esto tiene como objetivo reducir el consumo de tokens de IA al interactuar con herramientas como Cline que procesan la salida de la compilación. En el modo silencioso, el registro de compilación completo se guarda en /tmp/apptio-target-process-mcp/docker-build.log . Use el indicador --verbose para ver la salida de la compilación directamente en la terminal.

./scripts/build-local.sh # Quiet mode (default), logs to file ./scripts/build-local.sh --verbose # Full build output in terminal
  1. Ejecute la imagen local:
./scripts/run-local.sh
  1. Configurar Cline: Edite ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json :
{ "mcpServers": { "targetprocess": { "command": "./scripts/run-local.sh", "disabled": false, "autoApprove": [] } } }

Desarrollo local sin Docker

Prerrequisitos

  • Node.js 20 o posterior
  • npm

Configuración

  1. Clonar el repositorio recursivamente:
git clone --recursive https://github.com/modelcontextprotocol/targetprocess-mcp.git cd targetprocess-mcp

Nota: El indicador --recursive es necesario para clonar también el submódulo de la herramienta de búsqueda de documentación.

  1. Instalar dependencias:
npm install
  1. Copia la configuración de ejemplo:
cp config/targetprocess.example.json config/targetprocess.json
  1. Edite config/targetprocess.json con sus credenciales de Targetprocess.

Edificio

npm run build

Correr

node build/index.js

Capacidades de la API

Para obtener ejemplos detallados y casos de uso comunes, consulte USECASES.md .

El servidor MCP proporciona las siguientes herramientas para interactuar con Targetprocess:

entidades_de_búsqueda

Busque entidades de Targetprocess (UserStory, Bug, Task, Feature) con filtros e inclusiones.

{ "type": "UserStory", // Required: Entity type to search for "where": "EntityState.Name eq 'Open'", // Optional: Filter expression "take": 10, // Optional: Number of items to return (default: 100, max: 1000) "include": ["Project", "Team"] // Optional: Related data to include }

obtener_entidad

Obtenga información detallada sobre una entidad específica.

{ "type": "UserStory", // Required: Entity type "id": 123456, // Required: Entity ID "include": ["Project", "Team"] // Optional: Related data to include }

crear_entidad

Crea una nueva entidad en Targetprocess.

{ "type": "UserStory", // Required: Entity type to create "name": "Story Name", // Required: Entity name "description": "Details...", // Optional: Entity description "project": { // Required: Project to create in "id": 123 }, "team": { // Optional: Team to assign "id": 456 } }

entidad_actualización

Actualizar una entidad existente.

{ "type": "UserStory", // Required: Entity type "id": 123456, // Required: Entity ID "fields": { // Required: Fields to update "name": "New Name", "description": "New description", "status": { "id": 789 } } }

inspeccionar_objeto

Inspeccione los objetos y propiedades de Targetprocess a través de la API.

{ "action": "list_types", // Required: Action to perform "entityType": "UserStory", // Required for some actions: Entity type to inspect "propertyName": "Description" // Required for some actions: Property to inspect }

Consideraciones de rendimiento

Al trabajar con instancias grandes de Targetprocess que pueden contener millones de registros:

  1. Utilice consultas específicas : utilice siempre la consulta más específica posible para limitar los conjuntos de resultados
  2. Limitar el tamaño del resultado : utilice el parámetro take para limitar la cantidad de resultados devueltos
  3. Incluya solo los datos necesarios : incluya solo los datos relacionados que realmente necesita
  4. Considere la paginación : para conjuntos de resultados grandes, implemente la paginación en su aplicación
  5. Operaciones por lotes : para operaciones masivas, considere agrupar las solicitudes para evitar sobrecargar la API

Integración de LLM

Este servidor MCP se puede utilizar con varios asistentes de IA que admiten el Protocolo de contexto de modelo:

  • Cline : un asistente de IA basado en CLI
  • Claude Desktop : la aplicación de escritorio de Anthropic
  • Goose - Un asistente local de IA

Para obtener instrucciones de configuración e instalación, consulte llms-install.md .

Configuración

El servidor se puede configurar a través de variables de entorno o de un archivo de configuración JSON.

Formato de archivo de configuración

{ "domain": "your-domain.tpondemand.com", "credentials": { "username": "your-username", "password": "your-password" } }

Licencia

Instituto Tecnológico de Massachusetts (MIT)

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Tools

Proporciona herramientas para interactuar con Targetprocess, una plataforma de gestión de proyectos y planificación ágil, que permite a los asistentes de IA buscar, crear y actualizar entidades de proyecto con la validación adecuada.

  1. Key Features
    1. Use Cases
      1. Getting Started
        1. Development Resources
          1. Documentation Search
          2. CI/CD Pipeline
          3. Environment Variables
          4. Local Development with Docker
          5. Local Development without Docker
          6. Prerequisites
          7. Setup
          8. Building
          9. Running
        2. API Capabilities
          1. search_entities
          2. get_entity
          3. create_entity
          4. update_entity
          5. inspect_object
        3. Performance Considerations
          1. LLM Integration
            1. Configuration
              1. Config File Format
            2. License

              Related Resources

              Appeared in Searches

              ID: r67qn2xf6t